Flows
Flow authoring operations
List flows
Returns a paginated list of flows. Status/trigger/environment filters match on flow versions.
Create a new flow
Creates a new flow (parent identity) plus its first DRAFT version
Get a flow by code
Returns a single flow by its code
Get the latest published version of a flow
Returns the latest PUBLISHED version of a flow by its code
Get all versions of a flow
Returns all versions of a flow by its code, ordered by version descending
Get a specific version of a flow
Returns a specific version of a flow by its code and version number
Get flows that reference an event type anywhere in their definition
Get flows that reference an event type anywhere in their definition
Delete a flow
Cascade soft-deletes a flow and all of its versions
Get a flow by ID
Returns a single flow by its ID
Update a flow
Updates a flow's identity and its DRAFT version's settings. The step graph has its own endpoint.
Create a new version of a flow
Creates a new DRAFT version from the flow's latest PUBLISHED version
Archive a flow version
Archives a PUBLISHED or PAUSED version (→ ARCHIVED, terminal)
Get a flow version's step graph
Returns the step graph of a flow version. The response ETag is required for If-Match on write.
Replace a DRAFT version's step graph
Replaces the step graph of a DRAFT version. Supply the ETag from GET as If-Match for optimistic concurrency; a stale If-Match yields 412. The graph is structurally validated on write.
Pause a flow version
Pauses a PUBLISHED version (PUBLISHED → PAUSED)
Publish a flow version
Publishes a DRAFT version (DRAFT → PUBLISHED). The graph is hard-validated first.
Resume a flow version
Resumes a PAUSED version (PAUSED → PUBLISHED)
Dry-run test a flow version
Walks a DRAFT or published flow version without persisting runtime state or dispatching effects.