Execute an instant query

POST 
/query

Evaluates an instant query at a single point in time. If no time parameter is provided, the current time is used.

This endpoint is subject to the API's query limits and query freshness behavior.

Request

Responses

200

Successful query execution

400

Bad request — invalid or unparseable parameters (for example, a malformed PromQL expression or timestamp), or a query that exceeds the query limits (too many series, time range too long, or too many result points). Returned as a Prometheus-style JSON error with errorType: bad_data.

401

Unauthorized — missing or invalid authentication. Triggered when the Authorization header is absent or the access key (Client ID / Client Secret) is invalid. Returned as a plain-text body, for example missing Authorization request header.

422

Unprocessable entity — the backend could not execute the query. Try adjusting the query, time range, or step and retry. Returned as a Prometheus-style JSON error.

500

Internal server error — an unexpected failure while resolving metrics or executing the query. Returned as a Prometheus-style JSON error.