Scheduled runs

By the end of this page you will have put a deployed agent on a recurring schedule and know how to run, pause, and review it.

Prerequisites

Admin role.
A deployment with at least one agent. See Managing agents.

What a scheduled run is

A schedule runs one of a deployment’s agents automatically at a recurring time, with a fixed input. It’s ideal for unattended, repeating jobs — for example, a Sales Ingestor Task Agent that ingests the previous day’s sales every night.

Schedules belong to the deployment, not the agent editor, so the same published agent can run on different schedules in different deployments.

The Schedules tab

Open a deployment and select Schedules. Each schedule shows the agent it runs, its cadence in plain language, its timezone, when it last ran and what happened, and when it runs next.

Schedules tab showing an agent scheduled nightly, with its cadence, timezone, next run, and last-run status

Creating a schedule

Add a schedule

Click Add Schedule and pick the agent to run — for example, Sales Ingestor.

Set the cadence

Choose how often it runs. In Simple mode, pick a Frequency — Every day, Weekdays (Mon–Fri), Specific days, or Every N hours — and a timezone. For full control, switch to Cron Expression and enter your own. The dialog shows the schedule in plain language so you can confirm it.

Create schedule dialog with agent selector, Simple/Cron cadence, timezone, and JSON input

Provide the input

Enter the input data (JSON) the agent receives on each run. Leave it empty if the agent needs no input.

Save

Save the schedule. It appears on the Schedules tab with its next run time.

Frequency and credits

Schedules fall into frequency tiers based on cadence:

Daily cadences allow up to a set number of runs per day.
Hourly cadences run more often.

Each tier reserves credits per month, shown on the schedule card and when you create it.

ℹ️

A schedule card shows runs used today against the day’s limit. When a daily limit is reached, Run Now is unavailable until the next day.

Managing a schedule

From a schedule’s actions you can:

Run Now — trigger a run immediately (subject to the daily limit).
Pause / Resume — stop and restart the schedule without deleting it.
View History — see past runs and their outcomes.
Edit — change cadence, timezone, or input.
Delete — remove the schedule.

Schedule history panel listing past runs with their status and timing

Common issues

The agent isn’t selectable — only deployed agents can be scheduled. Add it to the deployment first.
Run Now is greyed out — the daily run limit for the schedule’s tier has been reached.
A run failed — open View History and then the run in Monitoring to see what happened.