Input β
An input says what starts a flow: a schedule.
Syntax β
text
id[/"Label"/]@{ trigger: "schedule", cron: "β¦" }
id["Label"]@{ shape: input, trigger: "schedule", at: "β¦" }Settings β
| Setting | Required | Value | Example |
|---|---|---|---|
trigger | yes | "schedule" | trigger: "schedule" |
cron | a schedule needs cron or at, not both | text in crontab format | cron: "0 9 * * 1-5" |
at | a schedule needs cron or at, not both | a date and 24-hour time, written YYYY-MM-DDTHH:MM | at: "2026-12-24T09:00" |
timezone | no | a time zone name | timezone: "Europe/Madrid" |
cron repeats and at runs once. Both are read in timezone, which is UTC when you leave it out. Triggers covers the schedule trigger and the cron format in detail.
Where it can go β
An input sits at the top level of the workflow and holds nothing.
| Arrow | In from | Out to |
|---|---|---|
Arrow (-->) | β | flow |
Dotted link (-.-) | β | β |
An input can start any flow, even one inside another flow. One input can start several flows, and one flow can have several inputs.
Rules β
- An input sits at the top level of the workflow. β
INPUT_NOT_ROOT(error) - An input only has arrows to flows. β
EDGE_KIND_INVALID(error) - Nothing can point at an input. β
EDGE_KIND_INVALID(error) - An input has a
trigger. βMETADATA_REQUIRED(error) - A schedule has a
cronor anat. βMETADATA_REQUIRED(error) - A schedule doesn't have both
cronandat. βMETADATA_KEY_CONFLICT(error) - An input takes no settings other than
trigger,cron,atandtimezone. βMETADATA_UNKNOWN_KEY(warning) - The trigger is
"schedule". βMETADATA_INVALID_VALUE(error) cronis text in crontab format,atis text naming a real date and time, andtimezoneis text naming a known time zone. βMETADATA_INVALID_VALUE(error)- An input's id is used by no other node. β
ID_DUPLICATE(error)
Example β
Code:
mermaid
agentflow TB
weekday[/"Weekdays at 09:00"/]@{ trigger: "schedule", cron: "0 9 * * 1-5", timezone: "Europe/Madrid" }
launch["Launch day"]@{ shape: input, trigger: "schedule", at: "2026-12-24T09:00" }
flow triage["Issue triage"]
read["Read issues"]@{ instruction: "Summarise every open issue." }
end
flow announce["Announce"]
post["Post"]@{ instruction: "Post the launch announcement." }
end
weekday --> triage
launch --> announce
Common mistake β
An arrow from an input straight to a task.
Code:
mermaid
agentflow TB
weekday[/"Weekdays at 09:00"/]@{ trigger: "schedule", cron: "0 9 * * 1-5" }
flow triage["Issue triage"]
read["Read issues"]@{ instruction: "Summarise every open issue." }
end
weekday --> read
Input "weekday" can only start a flow, but "read" is a task. Point the arrow at a flow instead.