---
title: "POST /v1/metric-query/query"
method: POST
path: "/v1/metric-query/query"
tags: ["MetricQuery"]
---

# POST /v1/metric-query/query

`POST /v1/metric-query/query`

## Request

- The document declares no server URL.
- Auth: none declared

Query runs an instant query at a single evaluation time (Prometheus /api/v1/query).

## Request body

- MarksmanApiV1MetricQueryRequest: MetricQueryRequest is the request for instant query.
  - `uid` string
  - `query` string: Prometheus PromQL expression.
  - `time` string: Evaluation timestamp (Unix seconds). If not set or zero, use current time.

## Response `200`

OK

- MarksmanApiV1MetricQueryReply: MetricQueryReply returns the response from Prometheus /api/v1/query as a structured any type (status, data.resultType, data.result).
  - `response` object

## Changes

- **2026-03-17** `c5ee25d8231f`: 1 info
  - endpoint added
- **2026-02-28** `f5912329bb01`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/changes/v1/metric-query/query/post.md)

---

[API](https://skmtc.dev/aide-family/apis/aide-family-marksman-api.md) - [All operations](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/revisions/26ae221fccba?raw)