List your instances' metric label names
Lists the label names of your org's series, of those that match a
match[] selector when any is sent, as Prometheus's
GET /api/v1/labels does.
AuthorizationBearer <cc_...>An API key of your org, sent as Authorization: Bearer cc_.... Keys
start with cc_ and are otherwise opaque. Treat a key as a password:
anyone holding it can act with its scopes until it expires or is
revoked. Each operation's security requirement lists the scopes it
needs; an empty list means any valid key. The MCP server at /mcp
accepts agent keys and no other kind.
Scope: instances:read
match[]?array<>Series selectors, such as cloud_instance_cpu_seconds_total{project="p-default"}. A series matches when any of them does.
1 <= items <= 20start?stringThe start of the range, as an RFC 3339 time or Unix seconds.
1 <= length <= 40end?stringThe end of the range, as an RFC 3339 time or Unix seconds.
1 <= length <= 40limit?integerThe most items to return; 0 for no limit, as Prometheus takes it. The store's own limits apply either way. Grafana sends its data source's series limit, 40000 unless set.
0 <= valueApi-Version*stringThe API version the request is written against. This document
describes 2026-10-15. A missing header returns
400 api_version_required, and a version the API does not serve
returns 400 unsupported_api_version.
X-Cloud-Organization?stringThe Cloud organization whose metrics this data source requests. Required for the managed Grafana OAuth client, which forwards the querying user's WorkOS token with metrics:read:all-orgs. For that dedicated client and scope only, the API verifies the WorkOS issuer, audience and user, then checks current membership and read access in this requested org on every query. The token's org_id does not restrict this user-wide metrics grant. A missing, repeated or unauthorized org returns 403 insufficient_scope. Other callers may omit it; if provided, it must match the org their credential already authorizes. The header itself grants no access.
^org-[a-z0-9]([-a-z0-9]*[a-z0-9])?$5 <= length <= 63X-Correlation-ID?stringAn id of your own for this request, or for a group of requests, to
find them in our logs and yours. Logged with the request and returned
unchanged in X-Correlation-ID. The request id itself is always the
API's own, in X-Request-ID.
^[A-Za-z0-9._:-]+$1 <= length <= 128Org-Context?stringAdmin keys only: the id of the org to act in. Required with an admin
key, together with Access-Reason; with any other credential it
returns 400 invalid_request. Every request that carries it is
recorded in that org's operator-access log.
^org-[a-z0-9]([-a-z0-9]*[a-z0-9])?$5 <= length <= 63Access-Reason?stringAdmin keys only: why the operator is acting in the org, such as a
support ticket. Required with Org-Context. Recorded, verbatim, in
the org's operator-access log.
^[^\x00-\x1F\x7F]+$10 <= length <= 500Label names, or one label's values, as Prometheus returns them.
application/json- response
Prometheus's list of label names or values. Ignore fields you do not know.
status*stringsuccess. Open set; accept values not listed.
data*array<string>The names or values, sorted.
warnings?array<string>Problems that did not stop the request, such as a list cut short.
curl -X GET 'https://api.cloud.confidential.ai/v1/prometheus/api/v1/labels?match%5B%5D=cloud_instance_cpu_seconds_total&start=2026-10-22T16%3A00%3A00Z&end=2026-10-22T17%3A00%3A00Z&limit=1000' \ -H 'Api-Version: 2026-10-15' \ -H 'X-Correlation-ID: rollout-2026-10-22' \ -H 'Access-Reason: Support ticket 4821: customer asked why i-6d3f9h2k8mzr failed'{ "status": "success", "data": [ "__name__", "instance", "project" ]}List your instances' metric series GET
Lists the label sets of your org's series that match any of the `match[]` selectors, as Prometheus's `GET /api/v1/series` does. Query editors such as Grafana's call it.
List the values of a metric label GET
Lists the values that the label `name` takes in your org's series, of those that match a `match[]` selector when any is sent, as Prometheus's `GET /api/v1/label/{name}/values` does. `__name__` lists the metric names.