Workflow executions

Read an execution

Changed on

Returns the execution record. Large final snapshots are omitted by default and their size reported as finalSnapshotBytes; pass include=finalSnapshot for the full payload.

get/workflows/executions/{id}

Request

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

Path parameters

idstring required

The execution id.

Query parameters

includestring

Comma-separated extras. Supported: finalSnapshot.

Response

The execution.

idstring required
workflowIdstring required
revisioninteger required
aliasNamestring
organizationIdstring
correlationKeystring

Client-chosen key used to target the execution with signals.

idempotencyKeystring
status'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'timed_out' required
inputsobject required

Run inputs. Credential-named keys are masked on reads.

outputsobject
variablesobject
parentExecutionIdstring

Present on sub-workflow executions.

parentStepIdstring
metadataobject
startedAtstring date-time required
updatedAtstring date-time required
completedAtstring date-time

Example response

{
  "id": "exec_8f3a1b2c4d5e",
  "workflowId": "wf_ifWBbWfpug0n",
  "revision": 3,
  "aliasName": "live",
  "error": {
    "code": "HTTP_500"
  }
}

Changes