TriggerContext

Shape

• 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.

Graph

Used by