Skip to main content
GET
List Workflow Runs

Headers

x-api-key
string | null

Query Parameters

status
string | null

Filter by status or use 'active' for queued+running

workflow_id
string | null

Filter by specific workflow ID

limit
integer
default:100
Required range: 1 <= x <= 500

Response

Successful Response

job_id
string
required

Job (run) identifier.

workflow_id
string
required

Workflow identifier.

status
string
required

Current status (e.g. queued, running, completed, failed).

workflow_name
string
default:Untitled Workflow

Workflow name at the time of the run.

step
string | null

Current authoring step from the workflow.

user_id
string | null

User who created the workflow.

created_at
string<date-time> | null

Timestamp when the record was created.

updated_at
string<date-time> | null

Timestamp when the record was last updated.

queued_at
string<date-time> | null

Timestamp when the run was enqueued.

started_at
string<date-time> | null

Timestamp when execution started.

completed_at
string<date-time> | null

Timestamp when execution finished.

duration_ms
integer | null

Total run duration in milliseconds.

status_reason
string | null

Short reason explaining the current status.

error_message
string | null

Error message if the operation failed.

metrics
Metrics · object | null

Aggregate run metrics (rows in/out, costs, etc.).

blocks
any | null

Per-block detail; usually null in list responses.

blocks_count
integer
default:0

Number of blocks in the workflow at run time.