GET
Retrieve a workflow run

Authorizations

Authorization
string
header
required

Provide your API key in the Authorization header using Bearer auth

Path Parameters

id
string
required

Run ID returned when the workflow was started

Response

OK

A workflow run

id
string

Run ID (run_ prefix)

Example:

"run_0192f1c3a7b87c3e9a4f5b6c7d8e9f01"

object
string

Object type, always workflow.run

Example:

"workflow.run"

workflow
string

Workflow ID

Example:

"geekidea/drama-episode"

status
enum<string>

Status: pending / running / waiting_input / succeeded / failed / cancelled

Available options:
pending,
running,
waiting_input,
succeeded,
failed,
cancelled
Example:

"running"

progress
integer<int32>

Progress (0–100)

Example:

40

auto_continue
boolean

Whether steps continue without confirmation

budget_usd
number

Budget of the whole run (USD); null when unlimited

model_cost_usd
number

Settled model cost (USD)

fee_usd
number

Settled workflow fee (USD)

cost_usd
number

Settled charge (USD)

held_usd
number

Amount held for the segment in progress (USD); null when nothing is running

error_code
string

Error code when the run failed

steps
object[]

Steps

created_at
integer<int64>

Creation time (Unix seconds)

finished_at
integer<int64>

Finish time (Unix seconds); null when not finished