Get a workflow run by ID
Retrieves the current state of a workflow run, including status, outputs, aggregated token usage, cost, and errors. Poll this endpoint after receiving a webhook notification, or use it to check the status of a run in progress.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Workflow run ID
Response
Workflow Run
Workflow run status and results.
Workflow run ID.
Current run status.
pending, completed, failed Timestamp when the run was created.
Map of output node names to their values. Only completed output nodes appear, so a pending or failed run can return a partial map — read status for completeness.
Node run messages: failures, warnings from nodes that completed anyway (e.g. a non-fail-fast assertion), and the latest error of a node still retrying. Non-empty does not mean the run failed — read status.
Timestamp when the run finished. Null while the run is pending.
Aggregated token usage across the workflow run. Null while pending.
Aggregated cost breakdown across the workflow run. Null while pending, or when no published rate covers one of its runs.