Get a run
Fetch one run by id. By default this returns core metadata plus terminal output/error fields. Pass ?expand=input,usage,execution,debug to include detailed sub-objects; expand=execution is also where embedded review and expected artifacts appear.
How to read a run: the envelope is at the root. The automation business result is in output (per-automation, not this generic schema). Status is execution.status (execution.retry.nextRun.status is a later retry). input, usage, and debug appear only with ?expand=. eval is present only on eval-scoped runs.
Authorizations
API key issued from Settings → API Keys. Pass as Authorization: Bearer <key>.
Path Parameters
Run id
Query Parameters
Optional sections: input, usage, execution, debug. Terminal runs always include top-level output, files, and error.
Response
Run detail. Expanded sections appear only when requested.
workflow, agent True when the run has reached a terminal status.
Deterministic pseudo-random rank in [0, 1) for this run within the tenant. Use with a sample rate threshold to review a stable subset.
0 <= x <= 1Slim execution metadata always present (status, schemaValid, batchId, retry). Pass expand=execution to replace with full RunExecution (WorkflowRunExecution or AgentRunExecution depending on run type).
- Option 1
- Option 2
- Option 3
Parent run id when this run was started by an invoke-workflow step. Omitted for top-level runs.
Present only on eval-scoped runs. Omitted otherwise.
Completed runs only. Per-automation business result — not a generic schema. Absent until the run completes.
Completed runs only. Download with GET /api/v1/runs/:id/artifacts/:path. Absent until the run completes.
Terminal failure message. Present on terminal runs; null when the run succeeded. Absent while the run is still in flight.
Present only with expand=input.
Present only with expand=usage. Null for old runs without telemetry.
Present only with expand=debug.