GET
Get a workflow run

Authorizations

Authorization
string
header
required

An API key minted in the console (ctd_…). Authenticates; never authorizes funds. A key carries scopes (read, wallets.write, transactions.write, events.write, webhooks.write, policy.write) and may be limited to vaults, to IP addresses, and in lifetime — see Authentication.

Path Parameters

id
string<uuid>
required

Response

The run.

run_id
string<uuid>
required
workflow
string
required
network
enum<string>
required

The network the data lives on. Required wherever it appears in a request — there is no default network. One your installation does not serve: 422 network_not_served.

Available options:
mainnet,
testnet
status
enum<string>
required
Available options:
running,
waiting,
completed,
failed,
cancelled
event
string | null
required

The name of the POST /events/{name} call that started the run, as the workflow listens on it; null for a run Citadel started (a deposit, a schedule) or another workflow called.

idempotency_key
string | null
required

That call's idempotency key; null when it sent none, or when Citadel started the run.

started_at
string<date-time>
required
failure_reason
string | null
finished_at
string<date-time> | null
outputs
object

What the steps produced.