Skip to content

Geo API (PREMIUM SELF)

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

Introduced in GitLab 16.7.

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.