Read a run

Returns a run's status, its progress and its result, in the same words the Web UI shows.

Last updated:

Returns a run's status, its progress and its result, in the same words the Web UI shows.

GET /api/v1/executions/{executionId}

Authorization

Requires a signed-in person with this scope: runs:read.

Parameters

NameInRequiredTypeDescription
X-Workspace-Idheaderyesstring (uuid)The workspace the call acts in. Take it from the workspace list.
executionIdpathyesstring (uuid)The run's id.

Responses

200

The run.

FieldTypeRequiredDescription
executionIdstring (uuid)yes
pipelineIdstring (uuid)yes
pipelineNamestringyes
statusone of PENDING, PREPARING, READY, EXECUTING, EXTRACTING, TRANSFERRING, LOADING, COMPLETING, HELD, COMPLETED, FAILED, CANCELLED, REJECTEDyes
startedAtstring (date-time)no
completedAtstring (date-time)no
initiatedBystringno
recordsProcessedintegeryes
bytesTransferredintegeryes
errorMessagestringno
heldReasonstringno
heldAtstring (date-time)no
createdAtstring (date-time)no
updatedAtstring (date-time)no
progressintegeryes
currentStagestringyes
actionslist of objectyes
actions[].actionIdstring (uuid)no
actions[].actionTypestringno
actions[].statusstringno
actions[].completedBlocksintegerno
actions[].totalBlocksintegerno
actions[].errorMessagestringno
actions[].stageslist of objectno
actions[].stages[].sequenceintegeryes
actions[].stages[].titlestringyes
actions[].stages[].statusone of NOT_RUN, PREPARING, DISPATCHED, COMPLETED, FAILED, HELDyes
actions[].stages[].recordsProcessedintegerno
actions[].stages[].unitsCompletedintegerno
actions[].stages[].unitsTotalintegerno
actions[].stages[].errorMessagestringno
actions[].stages[].mergeOutcomeobjectnoWhat a stage's merges did to the target; absent when the stage performed or reported no merge, which is not the same as three zeros.
actions[].stages[].mergeOutcome.insertedintegeryes
actions[].stages[].mergeOutcome.updatedintegeryes
actions[].stages[].mergeOutcome.unchangedintegeryes
actions[].parametersobjectno
actions[].exportArtefactobjectnoWhere an export put the data; absent when the export reported no artefact (a database-target export, or an agent too old to report one).
actions[].exportArtefact.namestringyes
actions[].exportArtefact.pathstringyes
actions[].exportArtefact.sizeBytesintegerno
actions[].exportArtefact.remotePathstringno
actions[].outputRefstringno
actions[].outputEnvironmentIdstring (uuid)no

Example response:

{
  "executionId": "6d4e5f60-7182-93a4-b5c6-d7e8f9a0b1c2",
  "pipelineId": "3a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9",
  "pipelineName": "Nightly customer sync",
  "status": "COMPLETED",
  "startedAt": "2026-10-12T09:10:00Z",
  "completedAt": "2026-10-12T09:12:30Z",
  "initiatedBy": "alex.morgan@example.com",
  "recordsProcessed": 1250,
  "bytesTransferred": 482300,
  "progress": 100,
  "currentStage": "Done",
  "actions": [
    {
      "actionId": "4b2c3d4e-5f60-7182-93a4-b5c6d7e8f9a0",
      "actionType": "COPY",
      "status": "COMPLETED",
      "completedBlocks": 3,
      "totalBlocks": 3,
      "parameters": {}
    }
  ]
}

400

A path id is not even syntactically a valid id (not a well-formed UUID) — distinct from 404, which means a well-formed id that simply does not exist.

FieldTypeRequiredDescription
messagestringyes
statusintegeryes
errorCodestringyes
timestampstring (date-time)no
pathstringno
detailsobjectno

403

The caller lacks the monitor right on this run's environments.

FieldTypeRequiredDescription
messagestringyes
statusintegeryes
errorCodestringyes
timestampstring (date-time)no
pathstringno
detailsobjectno

404

There is no such run.

FieldTypeRequiredDescription
messagestringyes
statusintegeryes
errorCodestringyes
timestampstring (date-time)no
pathstringno
detailsobjectno