Run a flow on a schedule
A scheduled flow starts an agent run at regular times instead of waiting for an event. Use it for recurring work such as a weekly repository health check, a daily documentation sweep, or a monthly review of a CRM account.
Before you start
Create the agent that the flow should run.
Decide what the agent should work on. A scheduled flow has no triggering event, so you must pick a specific target or the whole workspace.
You need permission to edit flows in the workspace.
Create a scheduled flow
Go to Automation → Flows and create a flow. Pick a template or choose Build a custom flow.
Enter a Flow name.
In the When row, choose Schedule ticks from the Advanced group.
In the schedule panel, set when the flow runs with Simple builder or Advanced cron. See the sections below.
In the then row, Start an agent run is selected. Choose the agent after using.
In the on row, choose a specific task, epic, repository, CRM deal, contact, or company, or choose this workspace.
Select Create flow.
Use the simple builder
The simple builder covers most schedules. Times use your workspace time zone, which is shown next to the time.
Frequency | What you set |
|---|---|
Every hour | The minute past each hour |
Every day | The time of day |
Every week | One or more days of the week, and the time |
Every month | The day of the month, and the time |
A preview below the settings describes the schedule in plain language, so you can confirm it before saving.
Use an advanced cron expression
Choose Advanced cron to enter a standard five-field cron expression, for example 0 9 * * 1-5. Advanced cron expressions are evaluated in UTC. If your expression matches a simple hourly, daily, weekly, or monthly pattern, you can switch back to the simple builder.
Run a scheduled flow now
To test a scheduled flow without waiting, open it from the Flows list and select Run now. You can also find Run now in the flow's row menu. It's available only for scheduled flows that start an agent run and have a complete setup, and not while the flow is already running.
Things to know
You can't add a semantic condition to a scheduled flow. The composer asks you to remove it before saving.
The Flows list shows each scheduled flow's Next run and Last run.
Pausing a flow stops its schedule until you turn it back on.
To review past runs, open the flow's Recent runs, or go to Automation → Activity.
Related
Was this article helpful?