PipelineRunSummary

Shape

• pipeline_namestring
• pipeline_run_idPipelineRunId (string · uuid)
• repo_idRepositoryId (string · uuid)
• started_atstring
• statusPipelineStatusrunningsucceededsucceeded_with_warningsfailedtimed_outcancelledPer-PipelineRun status.
• triggerTriggerContext

  • The TriggerContext schema
  • repo_idRepositoryId (string · uuid)
  • repo_pathstring
  • before_shastring or nulloptionalThe commit the ref pointed at before the push — what a paths filter compares against. On a run started by hand, the commit its starter named to compare from, if any.
  • branchstring or nulloptional
  • buildMrBuildTargetmerge_resultsourceor nulloptionalWhich commit a merge-request-triggered run built.
  • commit_shastring or nulloptional
  • depthinteger · int32optional0–∞How many pushes made by pipeline runs led to this run, one after another; 0 when no pipeline's push started it.
  • every_stepbooleanoptionalEvery step runs, whatever its path filter says — asked for by whoever started the run.
  • extraobjectoptionalAdditional fields supplied by whatever started the run, passed along without being interpreted.
  • kindTriggerKindpushmerge_requesttagschedulemanualoptionalWhat started this run.
  • mr_idMergeRequestId (integer · int64) or nulloptional
  • paramsobjectoptionalThe values a person supplied when starting the run, keyed by the parameter names the pipeline's manual trigger declares.
  • ref_namestring or nulloptionalThe full ref (e.g. refs/tags/v1.2.0). Set for runs a tag started, which branch cannot describe.
  • root_group_idGroupId (string · uuid) or nulloptionalThe organisation this run belongs to — the root group of the repository it was triggered for. Recorded when the run starts and never recalculated, so a repository moved to a different organisation part-way through a run keeps the artifacts, logs and cache it has already produced. Absent on runs that started before runs recorded this.
  • schedule_stemstring or nulloptionalWhich scheduled trigger fired, when kind is schedule.
  • source_shastring or nulloptionalThe source-branch commit this run tested: a merge request's source head for a merge-request run, whichever commit it built, and the commit itself for a push or manual run. Set by the platform; absent on a run whose graph the caller supplied, which never counts toward a merge request's pipelines.
  • target_branchstring or nulloptionalThe merge request's target branch.
  • target_shastring or nulloptionalThe target branch's tip this merge-request run was tested against. Once the target branch moves on, the merge check reports a merge-result run as out of date.
  • triggered_byActorSummaryoptionalWho started the run, set by the platform from the authenticated caller; a value supplied in a request is ignored.

    • The ActorSummary schema
    • emailstring
    • idstring
    • usernamestring
    • avatar_urlstring or nulloptional
  • trustTriggerTrusttrusteduntrustedoptionalWhether the code being built is trusted with the repository's connections and secrets. Set by the platform when the run starts, whatever a request says.
  • trust_reasonTrustReason or nulloptionalWhy the run has the trust it has: who wrote the code, a person's merge or approval, or the organization's AI configuration. Absent on runs that started before this was recorded.
• finished_atstring or nulloptional
• pipeline_idPipelineId (string · uuid) or nulloptionalThe pipeline definition this run was started from. Absent when that definition has since been deleted; pipeline_name still names what ran.
• re_run_ofPipelineRunId (string · uuid) or nulloptional
• stagesarray of StageRollupoptionalPer-stage counts of how many steps are in each status, in execution order — enough to draw the run's shape in a list. Empty for older runs recorded before these counts existed.

  • The StageRollup schema
  • barrier_passedbooleanWhether every step in the stage has finished.
  • countsNodeStatusCounts

    • The NodeStatusCounts schema
    • awaiting_approvalinteger · int32optional0–∞
    • cancelledinteger · int32optional0–∞
    • dispatchedinteger · int32optional0–∞
    • failedinteger · int32optional0–∞
    • pendinginteger · int32optional0–∞
    • runninginteger · int32optional0–∞
    • skippedinteger · int32optional0–∞
    • succeededinteger · int32optional0–∞
    • timed_outinteger · int32optional0–∞
  • stage_idStageId (string)
  • stage_indexinteger · int320–∞
  • tolerated_failuresinteger · int32optional0–∞How many of the stage's failed or timed-out steps were allowed to fail, so they degrade the run rather than fail it. Left out when zero.

Graph

Used by