Skip to navigation
ReferenceAPI ReferenceworkflowsRuns

Get Run

Fetch full detail for a single workflow run.

Returns all run fields plus definition_snapshot — the graph and execution config captured at the moment the run started. The snapshot is returned raw (no config migrations applied), so it faithfully represents the workflow as it existed for this specific execution even if the workflow definition has since been edited.

This is the heaviest run endpoint. For progress polling, use the lighter GET /runs/{run_id}/status which omits the snapshot. For aggregated visual metrics, use GET /runs/{run_id}/overview. For the per-node step log, use GET /runs/{run_id}/steps; opt into full results and audio playback URLs with include_result=true.

Authentication

AuthorizationBearer
Clerk JWT token
OR
AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Path parameters

workflow_idstringRequiredformat: "uuid"
run_idstringRequiredformat: "uuid"

Headers

X-Workspace-Idstring or nullOptional

Response

Successful Response
dataobject

Run detail response, including the graph/execution snapshot.

The snapshot is returned raw — no config migrations are applied — so it reflects the workflow exactly as it existed when the run started, even if the underlying workflow has since been edited.

metaobject

Errors

422
Unprocessable Entity Error