Skip to navigation

Flows · Runs · Get one run in full, including every task

View as Markdown

Returns the complete execution record: input, output, timings, and every task with its own input, output, status and retry count.

Use it when a run has finished and you need the task-by-task breakdown — which step failed, what a given step emitted, how long each took. It is a large payload and not intended for repeated polling.

Note workflow_id here holds the definition ID, a small integer — not the run ID, even though the field carrying a run ID elsewhere shares the name.

resource: workflow://run-control covers the two-ID confusion.

Authentication

AuthorizationApi-Key

Header authentication of the form Api-Key <token>

OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

run_idstringRequired

UUID of a single workflow execution, from flows_startWorkflow (returned as workflow_id) or flows_listWorkflowRuns (returned as id). NOT the small integer workflow-definition ID.

Query parameters

expandstringOptional

Comma-separated extras: creator for the user who started the run, input and output for the full payloads.

Response

Full run record including tasks.

Errors

404
Not Found Error