Skip to main content
A Schedule is a trigger attached to an Agent. It starts a Run at a future time or on a recurring cadence. Every Schedule belongs to exactly one Agent. Use schedules when an Agent should run without a person or application starting it manually.

​
Schedule types

Run once

Start the Agent exactly once at a specified time. Use this for one-off scheduled runs.

Run every interval

Start the Agent every N minutes, hours, or days from an anchor time. Use this for simple recurring patterns like “every 6 hours.”

Advanced CRON

Start the Agent from a CRON expression when you need precise calendar rules, such as weekdays at 9am.
API values are RunOnce = 1, RunEvery = 2, and CRON = 3.

​
Pause or remove a Schedule

A Schedule has an enabled flag. Disable a Schedule to prevent future fires without deleting its configuration. Delete a Schedule when you no longer need it.
If a Schedule fires while its Agent is archived, the resulting Run finishes as Skipped (11). Unarchive the Agent to resume.

List schedules

Find schedules for an Agent or Space.

Create a schedule

Attach a recurring or one-time trigger to an Agent.

Update a schedule

Change cadence, timing, or configuration for an existing schedule.

Disable a schedule

Pause future fires without deleting the schedule.

Delete a schedule

Remove a schedule you no longer need.