Tier: Premium, Ultimate Offering: Self-managed Status: Beta

The Geo API is used internally by GitLab components to assist in coordinating Geo actions. It is inaccessible to admins or users.

Fetch pipeline refs


This method returns a list of branches matching pipeline/refs/X that exist on the repository for gl_repository on the current Geo node. This endpoint is used by runners registered with a secondary Geo instance to check if a repository is up to date.

GET /geo/repositories/:gl_repository/pipeline_refs

Supported attributes:

Attribute Type Required Description
gl_repository string Yes The gl_repository ID of the repository to query

If successful, returns 200 and the following response attributes:

Attribute Type Description
attribute ‘array’ An array of ids matching refs/pipeline/X created for running pipelines.