v16

latestOpenAPI 3.1.1raw.githubusercontent.com2026-08-0124102197.4 KB
V3 Workflows

Retrieve a workflow run

Returns one workflow run by globally unique run id, including the full debug payload: the captured triggerPayload, the run data (per-step results), the persisted logs trace, and retry metadata (attempt, nextAttemptAt, lastErrorAt). Scope 1 deliberately exposes these as JSON dumps so users and agents can understand exactly what happened in a run.

Poll this endpoint after POST /api/v3/workflows/{workflowId}/test: runs execute asynchronously and transition queuedrunningcompleted/failed/canceled.

Unknown or inaccessible run ids return 403 rather than 404 to avoid leaking cross-workspace resource existence.

get/api/v3/workflows/runs/{runId}

Path parameters

runIdstring cuid2 required

Workflow run identifier.

Response

Workflow run retrieved successfully