Skip to main content
GET
Get a workflow run

Path Parameters

runId
string<uuid>
required

The workflow run's id.

Response

The run with per-step progress.

A deterministic orchestration run with per-step progress.

id
string<uuid>
required
status
enum<string>
required
Available options:
pending,
running,
completed,
failed,
stopped
scriptPath
string

Reserved response field. The current host snapshots a local path into the run's stored source and does not retain or return the path, so this field is absent for both source forms.

Maximum string length: 4096
sessionId
string<uuid>

The session the run's agents work in, so their transcripts can be read back after the run and after a restart. Absent until the run has started one, and cleared if that session is later purged.

args
string[]
steps
object[]
error
object

Present when the run itself failed outside any step.

Example:
startedAt
string<date-time>
finishedAt
string<date-time>