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 (status, schemaValid, batchId, retry). Pass expand=execution to replace with full RunExecution (WorkflowRunExecution or AgentRunExecution depending on run type).

parentExecutionId
string

Parent run id when this run was started by an invoke-workflow step. Omitted for top-level runs.

eval
object

Present only on eval-scoped runs. Omitted otherwise.

output
object | null

Completed runs only. Per-automation business result — not a generic schema. Absent until the run completes.

files
object[]

Completed runs only. Download with GET /api/v1/runs/:id/artifacts/:path. Absent until the run completes.

error
string | null

Terminal failure message. Present on terminal runs; null when the run succeeded. Absent while the run is still in flight.

input
object

Present only with expand=input.

usage
object | null

Present only with expand=usage. Null for old runs without telemetry.

debug
object

Present only with expand=debug.