Skip to content

Metadata API

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

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.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",
    "version": "15.0.0"
  },
  "enterprise": true
}