Schedule

Unified scheduled triggers for Agent / Chatflow / Workflow · 6 modes · State machine

Schedule is the Workbench's unified scheduling entry point. Configure a schedule on any Agent / Chatflow / Workflow and it will run automatically.

Supported App Types

App	Required	Optional
Prompt Agent	`message` (instructions to the Agent)	—
Chatflow	`message`	`inputs` (start node parameters)
Workflow	—	`inputs` (start node parameters)

6 Scheduling Modes

Mode	Configuration	Example
once	A single timestamp	Run once on 2026-06-01 09:00
interval	Interval (min/hr/day)	Run every 30 minutes
daily	Every day at HH	Every day at 09:00
weekly	Day of week + time	Every Monday at 09:00
monthly	Day of month + time	The 1st of every month at 09:00
cron	Cron expression	`0 9 * * MON-FRI` (workdays 09:00)

Live preview of next runs

Once configured, the schedule card immediately shows the next 5 execution times for visual verification.

State Machine

[Active] ←─┐
   │       │
   ↓ pause │ resume
[Paused] ──┘
   │
   ↓ done (once)
[Completed]
   │
   ↓ reactivate
[Active]

State	Behavior
Active	Participates in scheduling + allows manual trigger
Paused	Does not schedule + allows manual trigger
Completed	Terminal state for once mode; can be reactivated

Run Records

Every execution (whether scheduled or manual) produces a run record:

Field	Description
Source	schedule / manual
Status	running / success / failed
Latency	Total execution milliseconds
Start/end time	UTC + user time zone
Input / output	Full snapshot
Trace	Jump to Trace for node-level detail

Records belong to the schedule

Even if the schedule is deleted, run records are retained (for audit).

Notifications

When execution completes, the creator receives an in-app message:

Success / failure status
One-line summary
Click into the run record details

Concurrency

The same schedule allows concurrent execution (independent records, no blocking).

Example: runs every 5 minutes, but a single run takes 8 minutes — the schedule still creates a new run every 5 minutes, so 1–2 parallel executions may exist. If your business doesn't allow concurrency, lock inside the app.

Variables

The message field supports template variables:

Variable	Meaning
`{{start_time}}`	The scheduled start time of this run (user time zone, YYYY-MM-DD HH:mm:ss)

Example:

Generate the sales report for the 24 hours before {{start_time}}.

MVP Limitations

The current MVP does not yet support (on the roadmap):

Event triggers / Webhook triggers (partially supported in Workflow triggers — see Workflow)
Retry policy configuration
Cross-task DAG dependencies
Canary / multi-environment
After deletion, records cannot be recovered

→ Full roadmap

Next Steps

Trigger Workflow from API → Workflow API
View execution traces → Observability

On this page