Skip to main content
GET
Get a run

Authorizations

Authorization
string
header
required

API key issued from Settings → API Keys. Pass as Authorization: Bearer <key>.

Path Parameters

id
string
required

Run id

Query Parameters

expand
string

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.

id
string
required
type
enum<string>
required
Available options:
workflow,
agent
finished
boolean
required

True when the run has reached a terminal status.

sampleRank
number
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.

Required range: 0 <= x <= 1
timing
object
required
source
object
required
trigger
object
required
execution
object
required

Slim execution metadata always present. Pass expand=execution to replace with full RunExecution (WorkflowRunExecution or AgentRunExecution depending on run type).

eval
object

Present only when the run is eval-scoped.

output
object | null

Completed runs only.

files
object[]

Completed runs only. Download with GET /api/v1/runs/:id/artifacts/:path.

error
string | null

Terminal failure message. Null when the run succeeded or is still in flight.

input
object

expand=input.

usage
object | null

expand=usage. Null for old runs without telemetry.

debug
object

expand=debug.