Skip to main content
GET
Retrieve a workflow run

Authorizations

Authorization
string
header
required

Secret key (sk_live_...)

Path Parameters

workflow_run_id
string
required

Unique identifier for the workflow run (prefixed with wrun_).

Pattern: ^wrun_
Example:

"wrun_AbC123xYz456"

Query Parameters

include
string

Comma-separated list of additional fields to include on each task_runs entry. Supported values: input, storage, artifacts. Sections are omitted from the response (not returned as null) when their flag is not present.

Response

OK

Workflow run object.

id
string
required

Unique identifier for the workflow run, prefixed with wrun_.

Pattern: ^wrun_
Example:

"wrun_AbC123xYz456"

object
string
required

Always workflow_run.

workflow_id
string
required

The workflow that was run.

Pattern: ^wflo_
Example:

"wflo_AbC123xYz456"

status
enum<string>
required

Lifecycle state. paused means the current step is waiting on external input; the step's own status carries the reason.

Available options:
queued,
running,
paused,
completed,
failed,
canceling,
canceled
result
null | string
required

Outcome once terminal: success only when every task run succeeded, failure if any failed, unknown otherwise. null while running and for a canceled run.

runtime_ms
null | integer<int64>
required

Milliseconds from the first step's start until the run reached a terminal status, excluding time spent queued. null until terminal.

session_id
null | string
required

The session every step of this run executes in. Prefixed with sess_. Assigned when the run is created through the API, or when a trigger-created run is admitted, so null while such a run is queued.

trigger_id
null | string
required

The trigger that created this run. Prefixed with trg_. null for runs created through the API.

steps
object[]
required

Per-step state, in definition order.

errors
null | object[]
required

Error objects, each naming its step, when the run failed. null otherwise.

created_at
string<date-time>
required
Example:

"2026-06-18T00:00:00Z"

updated_at
string<date-time>
required
Example:

"2026-06-18T00:00:00Z"

request_id
string

Unique identifier for the API request. Include this when contacting support.