Skip to main content
GET
Get one flow run

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer stfy_live_…. See Authentication for how to get one and which scopes it needs.

Path Parameters

run_id
string
required

The run's id, from GET /v1/automations/runs

Response

200 - application/json

Successful Response

app_url
string
required

The run on Agent Studio's Executions page

error
string | null
required

Why it failed: the first failed step's error

flow_id
string
required

The flow it ran (GET /v1/automations/flows/{flow_id})

flow_name
string
required
id
string
required
last_step_at
string | null
required

When its last step ran, ISO 8601 UTC

record
RunRecord · object | null
required

The record it ran on; null for a run with none (a schedule)

started_at
string | null
required

When it started, ISO 8601 UTC; null while queued

status
enum<string>
required

queued (waiting for a worker), running, completed, failed, waiting (a wait step: a sleep or an email reply) or awaiting_approval (an approval step)

Available options:
queued,
running,
completed,
failed,
waiting,
awaiting_approval
steps
RunStep · object[]
required

Its steps in the order the flow runs them

triggered_at
string | null
required

When it was queued, ISO 8601 UTC

steps_truncated
boolean
default:false

Some steps are left out: more than 100 steps ran, or the run wrote more than 1000 step records and the oldest steps were not read