~/docs/tasks
Tasks
Cron-based schedulers that fire workflows on a schedule.
A Task is a cron-based scheduler — pure configuration. It links a cron expression to a workflow. When a Task fires, OpenPieces automatically wakes the Events agent to execute the linked workflow.
Task Types
one-time
Fires once at a scheduled date and time.
recurring
Fires on a schedule defined by interval type, interval value, and optional time-of-day.
Scheduling Options
| Field | Description |
|---|---|
| intervalType | minutes, hours, daily, weekly, monthly |
| intervalValue | Every N minutes/hours |
| dayOfWeek | 0 (Sunday) through 6 (Saturday) |
| dayOfMonth | 1 through 31 |
| timeOfDay | HH:MM format in the specified timezone |
Status Reference
active — Task is running and will fire on schedule
paused — Task exists but will not fire
completed — One-time task that has already fired
The AI tracks lastRunAt andnextRunAt timestamps for every task, making it easy to see execution status at a glance.
Learn how secrets keep your services secure.Secrets