v1

latestOpenAPI 3.1.0Proprietary2026-07-265759203.4 KB

Workflow

List Workflow Runs

List recent workflow runs for the organization, sorted by most recent first. Optionally filter by status (running, completed, cancelled, or active for queued+running) and workflow_id.

get/workflows/runs

Query parameters

statusstring nullable

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

workflow_idstring nullable

Filter by specific workflow ID

limitinteger

Headers

x-api-keystring nullable

Response

Successful Response

job_idstring required

Job (run) identifier.

workflow_idstring required

Workflow identifier.

workflow_namestring

Workflow name at the time of the run.

statusstring required

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

stepstring nullable

Current authoring step from the workflow.

user_idstring nullable

User who created the workflow.

created_atstring date-time nullable

Timestamp when the record was created.

updated_atstring date-time nullable

Timestamp when the record was last updated.

queued_atstring date-time nullable

Timestamp when the run was enqueued.

started_atstring date-time nullable

Timestamp when execution started.

completed_atstring date-time nullable

Timestamp when execution finished.

duration_msinteger nullable

Total run duration in milliseconds.

status_reasonstring nullable

Short reason explaining the current status.

error_messagestring nullable

Error message if the operation failed.

metricsobject nullable

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

{"stackTrail":"components:schemas:WorkflowRunResponse:properties:blocks:anyOf","oasType":"schema","type":"unknown","title":"Blocks","description":"Per-block detail; usually null in list responses.","nullable":true}

blocks_countinteger

Number of blocks in the workflow at run time.