Skip to main content

​
What is a schedule?

A schedule is a recurring rule (cron + timezone) that creates jobs automatically at each trigger.

​
Cron expressions

Every 5 minutes

*/5 * * * *

Hourly

0 * * * *

Daily midnight

0 0 * * *

Weekdays 9 AM

0 9 * * 1-5

​
Timezone support

Set timezone to any IANA timezone, for example:
  • UTC
  • America/Los_Angeles
  • Europe/London
Cron interpretation depends on timezone. The same cron_expr runs at different UTC times across zones.

​
human_readable field

Schedule responses include human_readable, a helper string derived from cron_expr (for example, “Every minute” or “Every weekday at 9:00 AM”).

​
Schedule actions

​
actions
string[]
When enabled=true: ["pause", "delete"]. When enabled=false: ["resume", "delete"].
To pause/resume, update the schedule with enabled: false|true.

​
How schedules create jobs

When a schedule triggers, DispatchQ enqueues a new job using the schedule’s request settings.
Those jobs are linked with schedule_id, so you can filter/audit downstream runs by originating schedule.