v1

latestOpenAPI 3.1.0Apache-2.02026-07-226091175.5 KB
Runs

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.

get/api/v1/runs/{id}

Path parameters

idstring required

Run id

Run id

Query parameters

expandstring

Optional sections: input, usage, execution, debug. Terminal runs always include top-level output, files, and error.

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.

idstring required
type'workflow' | 'agent' required
finishedboolean required

True when the run has reached a terminal status.

sampleRanknumber required

Deterministic pseudo-random rank in [0, 1) for this run within the tenant. Use with a sample rate threshold to review a stable subset.

outputobject nullable

Completed runs only.

errorstring nullable