Execute Workflow
Run a workflow synchronously. Returns 200 if the run reaches a terminal state (completed, failed, cancelled) and 202 if the run pauses awaiting external input (paused).
By default the latest deployed workflow state is used. Pass useDraftState: true to run the draft state, or workflow to run an inline state graph.
Documentation Index
Fetch the complete documentation index at: https://docs.beltic.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Beltic-issued JWT bearer token.
Body
Workflow ID to execute.
Optional inline workflow state. When provided, replaces the persisted workflow definition for this run.
When true, run the workflow's draft state instead of the latest deployed version. Defaults to false.
Runtime options for an execution.
Partial re-run descriptor. The referenced execution must already exist; raw source-state injection is intentionally unavailable to public callers.
Parent execution ID when this run is a subworkflow.
Ancestor workflow IDs leading to this run. Used for cycle detection in subworkflows.
1Response
Execution reached a terminal state.
Result of an execution. Returned by POST /v1/workflows/execute with status 200 (completed/failed) or 202 (paused).
Normalized block output keyed by block ID.
Error message when the run did not complete successfully.
Terminal or paused status of a workflow execution.
completed, failed, paused, cancelled Active pause points when the run is paused awaiting external input.
Block-level execution logs.
Compact snapshot of final execution state. Populated on successful completion to support future partial (run-from-block) re-runs.