Metadata API

DETAILS: Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

Introduced in GitLab 15.2.

enterprise introduced in GitLab 15.6.

kas.externalK8sProxyUrl introduced in GitLab 17.6.

Retrieve metadata information for this GitLab instance.

GET /metadata

Response body attributes:

Attribute	Type	Description
`version`	string	Version of the GitLab instance.
`revision`	string	Revision of the GitLab instance.
`kas`	object	Metadata about the GitLab agent server for Kubernetes (KAS).
`kas.enabled`	boolean	Indicates whether KAS is enabled.
`kas.externalUrl`	string or null	URL used by the agents to communicate with KAS. It's `null` if `kas.enabled` is `false`.
`kas.externalK8sProxyUrl`	string or null	URL used by the Kubernetes tooling to communicate with the KAS Kubernetes API proxy. It's `null` if `kas.enabled` is `false`.
`kas.version`	string or null	Version of KAS. It's `null` if `kas.enabled` is `false`.
`enterprise`	boolean	Indicates whether GitLab instance is Enterprise Edition.

Example request:

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/metadata"

Example response:

{
  "version": "15.2-pre",
  "revision": "c401a659d0c",
  "kas": {
    "enabled": true,
    "externalUrl": "grpc://gitlab.example.com:8150",
    "externalK8sProxyUrl": "https://gitlab.example.com:8150/k8s-proxy",
    "version": "15.0.0"
  },
  "enterprise": true
}