Scheduled triggers run agents at regular times without an event. Use them for recurring tasks like daily reports, weekly cleanup, or periodic syncs.
Schedule types
Cron
Run at specific times using a cron expression:
{
"schedule_type": "cron",
"cron_expression": "0 9 * * MON-FRI"
}
minute hour day-of-month month day-of-week.
| Example | Schedule |
|---|
0 9 * * * | Every day at 9:00 AM |
0 9 * * MON-FRI | Weekdays at 9:00 AM |
0 */2 * * * | Every 2 hours |
0 0 1 * * | First day of each month at midnight |
Interval
Run at a fixed interval in seconds:
{
"schedule_type": "interval",
"interval_seconds": 3600
}
The minimum interval is 60 seconds.
Configuration
| Field | Type | Required | Description |
|---|
schedule_type | "cron" or "interval" | Yes | Type of schedule |
cron_expression | string | When cron | Standard cron expression |
interval_seconds | integer | When interval | Seconds between runs (minimum 60) |
Validation
cron_expression is required when schedule_type is "cron"interval_seconds is required when schedule_type is "interval"- Interval must be at least 60 seconds
Schedule info
Once a scheduled agent is created, you can query its next run times through the GraphQL API. The ScheduleInfo type returns upcoming execution times.
Next steps
