Skip to main content
GET
Get a run

Authorizations

Authorization
string
header
required

API key issued from the Blend AI dashboard. Prefix: bai_. Send as Authorization: Bearer bai_....

Path Parameters

runId
string
required

Run ID returned from POST /api/v1/responses.

Response

Run detail.

id
string
required
Example:

"run_xyz789"

status
enum<string>
required

Terminal states are completed, failed, cancelled.

Available options:
pending,
running,
completed,
failed,
cancelled
published_workflow_id
string | null
published_workflow_version_id
string | null
output
object | null

Present only when status is completed. Keys are normalized labels of each User Result node. Values are ordered arrays of result output items.

Example:
error
string | null

Error message if status is failed.

total_cost
number | null

Total cost of the run in USD.

Example:

0.0123

created_at
string<date-time> | null
completed_at
string<date-time> | null