Metadata API

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

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
}