Run MPL query to edge deployment

POST/v1/query/_mpl

Runs an MPL query against metrics datasets in this edge deployment. The response format follows the format parameter or the Accept header and defaults to metrics-v2. Returns 429 when a query cost limit is exhausted.

Warning

Use this endpoint to query data from a specific edge deployment. The data you query must be stored in the edge deployment where you query it. For more information, see Query data and Edge deployments.

The base domain for this endpoint is the base domain of the edge deployment where you want to query data.

Edge deployment	Base domain for ingest and query
`US East 1 (AWS)`	`us-east-1.aws.edge.axiom.co`
`EU Central 1 (AWS)`	`eu-central-1.aws.edge.axiom.co`

This endpoint only supports API tokens. Personal access tokens (PATs) aren't supported. For more information, see Tokens.

Parameters

Property	Type	Location	Description
`format`	`string`	`query`	Response format. If omitted, the Accept header is used for content negotiation. Defaults to metrics-v2 when neither is specified.

Body

application/json

Property	Type	Description
`endTime`	`string`Required	End time for the query range
`mpl`	`string`	The MPL query.
`startTime`	`string`Required	start and end time for the query, these must be specified as RFC3339 strings or using relative time expressions (e.g. now-1h, now-1d, now-1w, etc)

Request

curl -X POST 'https://{axiom-domain}/v1/query/_mpl' \
  -H 'Authorization: Bearer API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"endTime":"string","mpl":"string","startTime":"string"}'

Try itRun this request against your Axiom organization

Credentials stay in this browser tab and are only sent to Axiom when you run the request.

API token Requiredformat queryRequest body application/json

Response

200Query result in the requested format.

application/json

429Too Many Requests

defaultUser or system error

application/json