Skip to main content
GET
Get a workflow run

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Workflow run id or external execution id.

Response

The workflow run with its executed graph.

id
string
required

External execution id when the run was started through the public API, otherwise the internal run id.

promptVersionId
string<uuid>
required
status
enum<string>
required

Lifecycle status of a workflow run. Terminal statuses are completed, cancelled, failed and timeout. requires-action and waiting-for-review are active states where the run is paused for external input.

Available options:
pending,
running,
completed,
failed,
requires-action,
cancelled,
timeout,
waiting-for-review
startedAt
string<date-time>
required
completedAt
string<date-time> | null
required
input
object
required

Runtime variables the run was started with, keyed by variable name.

steps
object[]
required

Visible steps in topological order. Steps on unselected condition branches or outside a partial run's start/end range are reported as skipped.

graph
object
required
environment
enum<string>

Surface that started the run.

Available options:
test-case,
craft-preview,
api,
workstation
output
object | null

The completed leaf step whose output is the run's result. null while no leaf step has completed.