> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creao.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Scheduled Runs

> Run agents on a recurring schedule — automate daily reports, weekly summaries, and regular data processing.

## Overview

Scheduled Runs let you execute agents automatically on a recurring basis. Set up a schedule once, and the super agent runs it at the specified intervals — delivering results without manual intervention.

## Setting up a schedule

<Steps>
  <Step title="Open an agent">
    Navigate to the **Agents** page and select the agent you want to schedule.

    <Frame caption="The Agents page listing your available agents">
      <img src="https://mintcdn.com/creaoagent/L7jvWhXluKR0aaCS/images/agents-listing.png?fit=max&auto=format&n=L7jvWhXluKR0aaCS&q=85&s=147175180993233718b0006813c9331f" alt="Agents listing page showing agent cards with names and descriptions" width="1280" height="800" data-path="images/agents-listing.png" />
    </Frame>
  </Step>

  <Step title="Configure the schedule">
    Click the **Schedule** tab on the agent detail page, then click **+ Create Schedule**.

    <Frame caption="The Schedule tab with the option to create a new schedule">
      <img src="https://mintcdn.com/creaoagent/Qe1AeD0g4oCCFKCZ/images/scheduled-schedule-tab.png?fit=max&auto=format&n=Qe1AeD0g4oCCFKCZ&q=85&s=54ab72ed5c995d84884acea6dbb43fa8" alt="Schedule tab on agent detail page" width="1280" height="800" data-path="images/scheduled-schedule-tab.png" />
    </Frame>

    Configure your schedule settings:

    * **Frequency** — how often the agent runs (interval-based or custom cron expression)
    * **Time** — when during the day the run executes
    * **Timezone** — the timezone for scheduling
    * **Delivery** — choose whether to receive an email summary after each run (see [Email delivery](#email-delivery) below)

    <Frame caption="The schedule configuration dialog with interval and cron options">
      <img src="https://mintcdn.com/creaoagent/Qe1AeD0g4oCCFKCZ/images/scheduled-configure-form.png?fit=max&auto=format&n=Qe1AeD0g4oCCFKCZ&q=85&s=3aebd413e22ea5f43e748c77ec809617" alt="Schedule configuration form" width="1280" height="800" data-path="images/scheduled-configure-form.png" />
    </Frame>
  </Step>

  <Step title="Activate">
    Click **Create Schedule** to activate. The next run time appears in the agent detail page.
  </Step>
</Steps>

## Schedule options

| Frequency   | Description                               | Example                               |
| ----------- | ----------------------------------------- | ------------------------------------- |
| **Daily**   | Runs once every day at the specified time | Daily standup summary at 9:00 AM      |
| **Weekly**  | Runs once per week on the specified day   | Weekly analytics report every Monday  |
| **Monthly** | Runs once per month on the specified date | Monthly invoice generation on the 1st |
| **Custom**  | Cron expression for advanced scheduling   | Every weekday at 6:00 PM              |

## Email delivery

You can opt in to receive an email summary after each scheduled run. When email delivery is enabled, you get a formatted message with:

* **Run outcome** — whether the run succeeded, failed, or was skipped
* **Result summary** — a concise summary of what the agent produced
* **Session link** — a direct link to the full session for details

To enable it, set **Delivery** to **Email** when creating or editing a schedule. You can change the delivery setting at any time from the Schedule tab.

<Note>
  Email delivery is best-effort — if the summary email fails to send, the run itself is not affected.
</Note>

## Run history

Each scheduled execution creates a session entry in the agent's **Sessions** tab. You can:

* **View output** — see what the agent produced for each run
* **Check status** — confirm the run completed successfully or see a **Skipped** badge if the run was skipped due to insufficient credits
* **Review timing** — see exactly when each run executed
* **Delivery status** — see whether the result email was sent successfully (when email delivery is enabled)

<Frame caption="The Sessions tab shows the history of all scheduled and manual runs">
  <img src="https://mintcdn.com/creaoagent/Qe1AeD0g4oCCFKCZ/images/scheduled-sessions-tab.png?fit=max&auto=format&n=Qe1AeD0g4oCCFKCZ&q=85&s=123f19eb30574a2c70c6cf49e2c78f53" alt="Sessions tab with run history" width="1280" height="800" data-path="images/scheduled-sessions-tab.png" />
</Frame>

## Managing schedules

### Pausing a schedule

Toggle the schedule off to pause it. The configuration is preserved — toggle it back on to resume.

### Modifying inputs

Update the default inputs for scheduled runs at any time. Changes take effect on the next scheduled execution.

### Deleting a schedule

Remove the schedule entirely from the agent detail page. Past run history is preserved.

<Note>
  Scheduled runs consume credits just like manual runs. Monitor your usage on the billing page to avoid unexpected costs.
</Note>

## Skipped runs and auto-pause

If your account runs out of credits, scheduled runs are **skipped** instead of failing. Skipped runs show a **Skipped** badge in the Sessions tab and count toward the auto-pause threshold.

When a schedule accumulates **2 consecutive skipped runs**, it is automatically paused and you receive an email explaining:

* Why the schedule was paused (insufficient credits)
* How to resume (add credits and re-enable the schedule)

You can re-enable a paused schedule at any time from the Schedule tab. The auto-pause counter resets when you manually re-enable.

<Warning>
  Skipped runs auto-pause faster than other failures (2 consecutive skips vs 5 for general errors) to avoid silently burning through daily credit grants on schedules that cannot succeed.
</Warning>

## Use cases

<CardGroup cols={2}>
  <Card title="Daily reports" icon="newspaper">
    Generate a morning briefing from your email, calendar, and project management tools.
  </Card>

  <Card title="Weekly summaries" icon="chart-line">
    Compile analytics data into a formatted report every Monday.
  </Card>

  <Card title="Data monitoring" icon="bell">
    Check external data sources on a schedule and surface anomalies.
  </Card>

  <Card title="Content generation" icon="pen">
    Produce recurring content like social media posts or newsletter drafts.
  </Card>
</CardGroup>
