Skip to content
GitmoapAPIBeta
Schema

NodeView

One step of a pipeline run: where it sits in the run, its status and timings, and its earlier attempts.

Shape

  • attemptinteger · int320–∞
  • capability_idCapabilityId (string)The capability this step runs, as {provider}:{name} (e.g. docker:build).
  • historyarray of NodeAttemptRecordEarlier attempts of this step after retries, oldest first.
    • The NodeAttemptRecord schema
    • attemptinteger · int320–∞
    • finished_atstringWhen the attempt ended, RFC 3339.
    • node_run_idNodeRunId (string · uuid)
    • statusNodeStatuspendingawaiting_approvaldispatchedrunningsucceededfailedtimed_outskippedcancelledWhere a step has got to.
    • exit_codeinteger · int32 or nulloptional
  • logs_hrefstringRelative URL of this step's logs.
  • node_idNodeId (string)
  • node_run_idNodeRunId (string · uuid)
  • provider_idProviderId (string)The provider that runs this step (e.g. docker), as chosen from the catalog when the run started.
  • stage_idStageId (string)
  • stage_indexinteger · int320–∞
  • statusNodeStatuspendingawaiting_approvaldispatchedrunningsucceededfailedtimed_outskippedcancelledWhere a step has got to.
  • allow_failurebooleanoptionalThe author marked this step as allowed to fail: if it fails or times out, the stage and the run carry on (the run ends succeeded_with_warnings) and only the steps that depend on it are skipped. Show such a failure as a warning.
  • duration_msinteger · int64 or nulloptional0–∞
  • error_summarystring or nulloptionalWhy the step failed, skipped, timed out or was cancelled, in a sentence or two. For a step that failed after it ran, the same text as failure describes.
  • exit_codeinteger · int32 or nulloptional
  • failureNodeFailure or nulloptionalWhy a step that ran failed, as a cause a client can act on. Absent for a step that succeeded or never ran.
  • finished_atstring or nulloptional
  • namestringoptionalThe step's display name, as the pipeline's author wrote it when the run started. Empty for older runs recorded without one; show the capability instead.
  • originNodeOrigin or nulloptionalThe component this step was expanded from, when the author wrote a component instance rather than the step itself. Absent for a step the pipeline declares directly, and for runs that predate this field.
    • The NodeOrigin schema
    • component_idComponentId (string · uuid)
    • component_nameComponentName (string)
    • inner_node_idNodeId (string)This node's identifier inside the component body — what its author called it, before expansion prefixed it with the instance.
    • instance_idNodeId (string)The component instance in the pipeline the author wrote.
    • versionComponentVersion (string)The version the instance's reference resolved to.
  • retry_afterstring or nulloptionalWhen the platform next checks whether a held step can start, RFC 3339 — the wait timer's expiry, or the next check of the concurrency lock. Absent when nothing is scheduled, including while waiting for an approval, which a person gives rather than a clock.
  • started_atstring or nulloptional
  • waiting_onNodeWaitKindapprovalwait_timerconcurrency_lockor nulloptionalWhy a step that has not started is being held: it is waiting for an approval, for an environment's wait timer, or for another run to release its concurrency lock. Absent for a step that is simply waiting for the steps before it.

Example

Synthesized example
{
"attempt": 1,
"capability_id": "1c8a827d-2c04-4b13-9678-d8e1f6839469",
"history": [
{
"attempt": 1,
"finished_at": "2026-10-11T00:00:06Z",
"node_run_id": "6c933bd2-d12a-457b-8e42-5ed3ada1a00d",
"status": "pending"
}
],
"logs_href": "logs-href-4524",
"node_id": "102c4271-e510-411c-858d-877505158c1c",
"node_run_id": "9bb5e4c8-376b-407e-bfe2-aecae1756868",
"provider_id": "207d3565-1773-4347-b840-a39f84570790",
"stage_id": "89d448d6-9cf9-4ab5-bba5-87969e451a73",
"stage_index": 4,
"status": "pending",
"allow_failure": false,
"duration_ms": 10,
"error_summary": "error-summary-e0a7",
"exit_code": 88,
"failure": {
"kind": "setup_failed"
},
"finished_at": "2026-10-16T16:28:46Z",
"name": "payments-api",
"origin": {
"component_id": "1525b586-533e-42f3-9f45-997a35ba3e11",
"component_name": "payments-api",
"inner_node_id": "4d7482a3-21b4-4a52-a36c-160019d08ec2",
"instance_id": "081b28a6-1d5d-4b8f-a499-b4976e96a806",
"version": "version-9012"
},
"retry_after": "retry-after-8389",
"started_at": "2026-10-09T12:09:38Z",
"waiting_on": "approval"
}

Graph

Used by