Skip to main content
A schedule is a cron trigger on a workflow. It starts a run every time its cron expression matches, with no one needing to click anything. Use it for recurring work like a daily standup summary, a weekly report, or an hourly data check. To run an agent on a schedule, put it in a workflow with an agent_call node and give the workflow a cron trigger.

​
Example requests

  • “Every weekday at 9am Eastern, have the standup agent summarize yesterday’s commits and post them to #eng.”
  • “Run the invoice-reconciliation workflow on the first of every month at 6am UTC.”
  • “Check for stale support tickets every hour.”

​
How a schedule is defined

If the workflow has an input_schema, its defaults are filled in and the scheduled input is validated on every run. See State and input.

​
Building a schedule

Tell the Platform Agent what to run and how often. It turns a cadence like “every weekday at 9am ET” into 0 9 * * 1-5 in America/New_York, and asks for your timezone if it isn’t clear. In the workflow editor, add a trigger and choose a schedule. You can type a cadence under Describe it and click Generate, or enter a Cron expression directly. The editor previews the upcoming run times. If the workflow has an input_schema, fill in the Scheduled input there too.
A new or changed schedule starts firing only after you publish the workflow. Saving alone leaves it inert. Use Run now to test the workflow before you publish.

​
Managing schedules

  • Pause a schedule by removing its trigger (or commenting it out), then saving and publishing.
  • Change the cadence or input by editing the trigger, then saving and publishing.
  • Run now starts a run immediately, outside the schedule, using the latest saved version.
  • Run history on the workflow lists every scheduled run with its per-node trace.
Scheduled runs use the published version and run as the person who last published the workflow, so agents and app calls use that person’s access.

​
Approvals in unattended runs

A scheduled run usually has no one watching it. If an agent in the workflow has tools set to Ask (see Tool permissions), set an approval_channel on its agent_call node to send those approval requests to a Slack channel. To have a person sign off on a step, add a human_approval node. See Approvals in Slack.

​
Next steps

Workflows

Build the workflow a schedule runs.

Connector events

Start a workflow when something happens instead of on a timer.