Create Schedule
Create a one-shot schedule for an agent or workflow.
Type
schedule.createFolder
scheduleChannels
Any
Pipe
Value
Scope
Any
Create Schedule creates a one-shot job like Activity → Schedule. Choose Specific time (epoch milliseconds) or Timeout (minutes) (≥ 1). The target must be a general (not linked) agent or workflow.
The created schedule is active. Use pipe.value.id with Get Schedule, Update Schedule, or Delete Schedule.
For recurring runs, use Activity → Schedule (Repetitive).
Configure
| Setting | Description |
|---|---|
| Name | Required label |
| Trigger mode | Specific time or Timeout (minutes) |
| Scheduled at | Shown for Specific time — epoch milliseconds (number or variable) |
| Timeout (minutes) | Shown for Timeout — integer ≥ 1 |
| Target type | Agent or Workflow |
| Target | Eligible general agent or workflow (required) |
| Input schema | Shown when the target has input args |
Handles
| Handle | Role |
|---|---|
| In (target) | Incoming connection |
| Out (source) | Continues after the schedule is created |
Pipe schema
The next block reads this on the data pipe (pipe.value). The value is the created schedule. Use id for later steps. Typical fields:
| Key | Type | Description |
|---|---|---|
id | text | Schedule id |
name | text | Name |
isActive | boolean | Whether the job is active |
mode | text | specificTime or timeoutMinutes |
scheduledAt | datetime | Fire time in specific-time mode |
timeoutMinutes | number | Delay in timeout mode |
targetType | text | agent or workflow |
targetRef | text | Target id |
status | text | pending, running, success, or failed |
inputData | object | Input passed to the target when set |
Use case
- After a form submit, wait 30 minutes then start a reminder workflow.
- Schedule an agent at a datetime stored on a table row.