Scheduled triggers run agents at regular times without an event. Use them for recurring tasks like daily reports, weekly cleanup, or periodic syncs.Documentation Index
Fetch the complete documentation index at: https://colossal.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Schedule types
Cron
Run at specific times using a cron expression: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: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_expressionis required whenschedule_typeis"cron"interval_secondsis required whenschedule_typeis"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. TheScheduleInfo type returns upcoming execution times.
Next steps
- Event triggers. Trigger agents from commerce events instead of schedules
- Agent Builder overview. Learn how triggers, steps, and actions fit together