Metadata API
Tier: Free, Premium, Ultimate
Offering: GitLab.com, Self-managed, GitLab Dedicated
History
- 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
}