Flow Executions
Monitor and manage flow execution history and step-level details.
List flow executions
Retrieve a paginated list of executions for a specific flow.
query Parameters
flowIdThe flow ID to retrieve executions for. Format: UUID. Example: 5e104847-9564-8fa2-2431-844372809012.
page1-indexed page number to retrieve. Defaults to 1.
perPageNumber of executions to return per page. Defaults to 25.
List flow executions › Responses
Success response
Rerun a flow execution
Create a new execution based on an existing one, using the same inputs.
path Parameters
executionIdRerun a flow execution › Responses
Success response
Get execution step details
Retrieve the step-by-step execution trace for a specific flow execution.
path Parameters
executionIdGet execution step details › Responses
Success response
Run a flow
Trigger a new execution of the specified flow.
path Parameters
flowIdRun a flow › Request Body
environmentIdThe environment in which to run the flow. Format: UUID. Example: 4d0f3736-8453-7e91-1320-7332617f8901.
breakpointsStep references at which to pause execution. Only meaningful for non-PRODUCTION execution modes.
configurationIdOptional configuration to apply during execution. Format: UUID. Example: 92548281-3908-23e6-6875-288716243456.
draftIdOptional draft ID to execute a specific unpublished draft version. Format: UUID.
executionModeExecution mode for the run. DEBUG/TEST/REPLAY support step-through and breakpoint tooling; PRODUCTION is the normal run mode.
projectIdProject the flow belongs to. Format: UUID.
runFromWhere the run was triggered from — the UI, a trigger, or the public API.
Key-value pairs of variables to pass to the flow. Example: { "documentType": "invoice", "priority": "high" }.
workspaceIdWorkspace the flow belongs to. Format: UUID.
Run a flow › Responses
Success response