Skip to content
GitmoapAPIBeta
Schema

ComponentVersionSummary

A published version's metadata, without its body.

Shape

  • capability_requirementsarray of CapabilityId (string)The provider capabilities the version's steps use.
  • contract_digeststringA SHA-256 fingerprint, in hex, of what a pipeline using the version must satisfy: its parameters, its ports and the variables it reads. It changes only when that contract does.
  • depthinteger · int320–∞How many levels of components the version spans: 1 when it uses no other component.
  • expanded_node_countinteger · int320–∞How many steps the version expands into.
  • lifecycle_stateComponentLifecycleStateactivedeprecatedsunsetWhere a published version sits in its retirement. A deprecated version still resolves for an exact reference and still runs, but no floating reference selects it — which is what makes deprecating the safe way to retire one. A sunset version refuses to resolve at all, exact reference included.
  • published_atstring
  • published_byActorSummary
  • variable_requirementsarray of EnvironmentVariableName (string)The variables the version's steps read from the pipeline that uses it. Each must be declared on the environment those steps run in, or on a group or repository above the pipeline, or a run is refused when it starts.
  • versionComponentVersion (string)
  • changelogstring or nulloptional

Example

Synthesized example
{
"capability_requirements": [
"capability-requirements-ada6"
],
"contract_digest": "contract-digest-54cf",
"depth": 57,
"expanded_node_count": 3,
"lifecycle_state": "active",
"published_at": "2026-10-16T23:51:05Z",
"published_by": {
"email": "mara@acme.example",
"id": "id-a3df",
"username": "lin",
"avatar_url": "https://gitmoap.example/acme/dff1ee06"
},
"variable_requirements": [
"variable-requirements-ce66"
],
"version": "version-89c6",
"changelog": "changelog-d7a7"
}

Graph

Used by

Sent by 0 operations

No operation takes it as a request body.

Returned by 14 operations