Scheduled Workflows

Workflows can be scheduled on a recurring basis

Using the trigger field of a workflow config, you can configure your Workflow to run on a schedule with the cron setting.

The following workflow config is configured to run every two hours:

name: my-scheduled-workflow
trigger:
  cron:
    pattern: "0 */2 * * *"
actions:
  - ...

Cron Patterns

Workflows can be scheduled using standard cron syntax. Some examples include:

Cron Expression	Cadence
0 * * * *	Every hour at the beginning of the hour.
0 2 * * 1-5	2:00 AM from Monday to Friday.
0 0 * * 0	Midnight (00:00) every Sunday.
30 3 15 * *	3:30 AM on the 15th day of every month.

Predefined Schedules

You may use one of several pre-defined schedules in place of a cron expression.

Pattern	Cadence	Cron Equivalent
@yearly	Run once a year, midnight, Jan. 1st	0 0 1 1 *
@monthly	Run once a month, midnight, first of month	0 0 1 * *
@weekly	Run once a week, midnight between Sat/Sun	0 0 * * 0
@daily	Run once a day, midnight	0 0 * * *
@hourly	Run once an hour, beginning of hour	0 * * * *

Limitations

Each workflow can only have a single active run at a time. If a workflow is still running while a subsequent scheduled workflow reaches the evaluation window, the next workflow run is prevented from launching until the current run completes.