Sign in

v13

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-015232292.9 KB
Workflows

Get Execution Status

Get the current status of a workflow execution. Returns the run's lifecycle state (running, paused, completed, failed, etc.), timing, error, and optionally per-block outputs. Designed for polling — works for any execution, including ones that pause and resume.

get/api/workflows/{id}/executions/{executionId}

Path parameters

idstring required
Example:3b1f7c92-8d4e-4a6b-9c0d-5e2f8a714b36

The unique identifier of the workflow.

executionIdstring required
Example:e4f8d2b6-9a1c-4e3d-8b7f-5c0a2d9e6f13

The unique identifier of the execution.

Query parameters

includeOutput'true' | 'false'

When true and the execution has status: completed, include the workflow's final output in the response.

selectedOutputsstring
Example:c1b90bce-8a82-42a5-b6a5-5762846c2eaf,c1b90bce-8a82-42a5-b6a5-5762846c2eaf.waitDuration

Comma-separated block-output selectors. A bare blockId returns that block's full output; a dot-path like blockId.field or blockId.nested.path returns just that value. Results are returned in the blockOutputs map keyed by the selector string.

Response

Execution status returned.

executionIdstring

The unique identifier of the execution.

workflowIdstring

The unique identifier of the workflow.

status'pending' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled'

Current normalized lifecycle status. paused is set when a row exists in pausedExecutions with status paused or partially_resumed; otherwise the workflowExecutionLogs row's status field is used.

trigger'api' | 'manual' | 'schedule' | 'webhook' | 'chat'

What triggered the execution.

level'info' | 'warning' | 'error'

Log level of the execution.

startedAtstring date-time

ISO 8601 timestamp when execution started.

endedAtstring date-time nullable

ISO 8601 timestamp when execution ended. Null while the run is in flight.

totalDurationMsinteger nullable

Total duration of the execution in milliseconds. Null while the run is in flight.

errorstring nullable

Error message. Present only when status is failed.

finalOutputobject nullable

The workflow's final output. Returned only when ?includeOutput=true AND status is completed.

blockOutputsobject nullable

Per-block outputs keyed by the selector string. Returned only when ?selectedOutputs is set.

Example response

{
  "executionId": "9254f1c9-5a11-4a12-91e3-8065293f3609",
  "workflowId": "81f661e1-d704-4861-b5c1-5bb3cf57e6a7",
  "status": "completed",
  "trigger": "api",
  "level": "info",
  "startedAt": "2026-05-15T19:43:12.189Z",
  "endedAt": "2026-05-15T19:45:45.224Z",
  "totalDurationMs": 153035,
  "paused": {
    "pausedAt": "2026-05-15T22:25:57.216Z",
    "resumeAt": "2026-05-16T18:25:57.200Z",
    "pauseKind": "time",
    "blockedOnBlockId": "c1b90bce-8a82-42a5-b6a5-5762846c2eaf",
    "pausedExecutionId": "438bf05b-bd3c-4011-b78e-b19c112eeb66",
    "pausePointCount": 1
  },
  "cost": {
    "total": 0.005
  },
  "blockOutputs": {
    "c1b90bce-8a82-42a5-b6a5-5762846c2eaf.waitDuration": 60000,
    "c1b90bce-8a82-42a5-b6a5-5762846c2eaf.status": "completed"
  }
}