Workflow executions

Read execution state

Changed on

Returns a live state snapshot: per-step outputs, current steps, pending signal waits, variables, and run metadata. Queried live while the execution runs; rebuilt from storage afterwards.

get/workflows/executions/{id}/state

Request

  • Base URL
    https://api.nullplatform.com
  • URL
    https://api.nullplatform.com/workflows/executions/{id}/state
  • Auth
    HTTP bearer

Path parameters

idstring required

The execution id.

Response

The state snapshot.

executionIdstring
workflowIdstring
revisioninteger
status'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'timed_out'
inputsobject
variablesobject
outputsobject

Present once the execution completed.

stepsobject

Map of step id to its latest outputs and status.

currentStepsstring[]
startedAtstring date-time
updatedAtstring date-time
completedAtstring date-time

Example response

{
  "pendingWaits": [
    {
      "signalNames": [
        "approval:response"
      ]
    }
  ]
}

Changes