Start a run
Executes the named flow against the supplied inputs. By default the call is synchronous and returns the completed Run; pass wait=false to fire-and-poll, which returns the Run in a pending/running state with an id to poll via GET /runs/{id}. Inputs marked secret: true are resolved by the worker’s Secrets provider at run time and are never echoed back.
承認
A bearer token issued by the control plane. RBAC scopes which flows a token may run or read; secret values are never exposed regardless of role.
パスパラメータ
The deployed flow name.
クエリパラメータ
Block until the run finishes (synchronous). Defaults to true; set false for fire-and-poll.
ボディ
The flow's typed inputs as a JSON object (keys are the flow's input names).
The flow's typed inputs as a JSON object keyed by input name.
レスポンス
Synchronous run completed.
One execution of a FlowSpec, with its append-only Journal.
uuidv4.
Exactly which FlowSpec ran.
pending, running, succeeded, failed, canceled One append-only, content-addressed step-lifecycle event. Discriminated by event.
- run_started
- step_started
- step_succeeded
- step_failed
- step_skipped
- effect_recorded
- run_finished
The flow's output projection (any JSON value). Absent until the run succeeds.