2022-06-21 00:08:43 +00:00
---
2022-09-12 09:13:02 +00:00
stage: Configure
group: Configure
2022-09-21 21:13:33 +00:00
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments
2022-06-21 00:08:43 +00:00
---
# Metadata API **(FREE)**
2022-06-28 12:09:11 +00:00
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/357032) in GitLab 15.2.
2022-06-21 00:08:43 +00:00
2022-06-29 00:09:31 +00:00
Retrieve metadata information for this GitLab instance.
2022-06-21 00:08:43 +00:00
```plaintext
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` . |
Example request:
```shell
curl --header "PRIVATE-TOKEN: < your_access_token > " "https://gitlab.example.com/api/v4/metadata"
```
Example response:
```json
{
2022-06-28 12:09:11 +00:00
"version": "15.2-pre",
2022-06-21 00:08:43 +00:00
"revision": "c401a659d0c",
"kas": {
"enabled": true,
2022-07-05 03:08:33 +00:00
"externalUrl": "grpc://gitlab.example.com:8150",
2022-06-21 00:08:43 +00:00
"version": "15.0.0"
}
}
```