---
title: "Changes to Run an ad-hoc analytics query"
method: POST
path: "/analytics/query"
---

# Changes to Run an ad-hoc analytics query

`POST /analytics/query`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 8 of 149 revisions.

- **2026-09-22** `c42250b855e4` — 1 warning
- **2026-09-21** `ca8fb37253e5` — 1 info
- **2026-09-18** `0fb60b40c570` — 1 breaking
- **2026-09-15** `306accd8ee26` — 4 breaking
- **2026-09-15** `cb3984fd3acb` — 10 breaking, 5 warning, 25 info
- **2026-09-14** `5f9d16cd8235` — 1 info
- **2026-09-14** `7b140458b57e` — 1 breaking
- **2026-09-12** `aeb807837043` — 1 info

## Changes

- **2026-09-22** `c42250b855e4` — 1 warning
  - removed the request property `definition/name`
- **2026-09-21** `ca8fb37253e5` — 1 info
  - endpoint added
- **2026-09-18** `0fb60b40c570` — 1 breaking
  - api path removed without deprecation
- **2026-09-15** `306accd8ee26` — 4 breaking
  - the request property `definition/metrics` became required
  - the request property `definition/shape` became required
  - the request property `definition/variables/items/type` became required
  - the `definition/metrics` request property's minItems was increased to `1`
- **2026-09-15** `cb3984fd3acb` — 10 breaking, 5 warning, 25 info
  - request property `definition/filters/items/op` was restricted to a list of enum values
  - request property `definition/metrics/items/` was restricted to a list of enum values
  - request property `definition/sort/items/dir` was restricted to a list of enum values
  - request property `definition/time/grain` was restricted to a list of enum values
  - request property `definition/variables/items/type` was restricted to a list of enum values
  - the `definition/filters/items/value` request property type changed from `object` to `array`
  - the `definition/time/range` request property type changed from `object` to `string`
  - the `definition/variables/items/default` request property type changed from `object` to `array`
  - the `variables/additionalProperties/` request property type changed from `object` to `array`
  - the `rows/items/items/` response's property type changed from `object` to `string` for status `200`
  - added the new `datetime` enum value to the `columns/items/type` response property for the response status `200`
  - added the new `decimal` enum value to the `columns/items/type` response property for the response status `200`
  - added the new `dimension` enum value to the `columns/items/role` response property for the response status `200`
  - added the new `metric` enum value to the `columns/items/role` response property for the response status `200`
  - added the new `string` enum value to the `columns/items/type` response property for the response status `200`
  - added the new `after` enum value to the request property `definition/filters/items/op`
  - added the new `asc` enum value to the request property `definition/sort/items/dir`
  - added the new `before` enum value to the request property `definition/filters/items/op`
  - added the new `boolean` enum value to the request property `definition/variables/items/type`
  - added the new `contains` enum value to the request property `definition/filters/items/op`
  - added the new `date_range` enum value to the request property `definition/variables/items/type`
  - added the new `day` enum value to the request property `definition/time/grain`
  - added the new `desc` enum value to the request property `definition/sort/items/dir`
  - added the new `enum` enum value to the request property `definition/variables/items/type`
  - added the new `eq` enum value to the request property `definition/filters/items/op`
  - added the new `event_count` enum value to the request property `definition/metrics/items/`
  - added the new `gt` enum value to the request property `definition/filters/items/op`
  - added the new `gte` enum value to the request property `definition/filters/items/op`
  - added the new `hour` enum value to the request property `definition/time/grain`
  - added the new `in` enum value to the request property `definition/filters/items/op`
  - added the new `lt` enum value to the request property `definition/filters/items/op`
  - added the new `month` enum value to the request property `definition/time/grain`
  - added the new `not_contains` enum value to the request property `definition/filters/items/op`
  - added the new `not_in` enum value to the request property `definition/filters/items/op`
  - added the new `number` enum value to the request property `definition/variables/items/type`
  - added the new `string` enum value to the request property `definition/variables/items/type`
  - added the new `string_list` enum value to the request property `definition/variables/items/type`
  - added the new `usage_quantity` enum value to the request property `definition/metrics/items/`
  - added the new `week` enum value to the request property `definition/time/grain`
  - added the optional property `meta/query_source` to the response with the `200` status
- **2026-09-14** `5f9d16cd8235` — 1 info
  - endpoint added
- **2026-09-14** `7b140458b57e` — 1 breaking
  - api path removed without deprecation
- **2026-09-12** `aeb807837043` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/flexprice/apis/flexprice-api/docs/analytics/query/post.md) · [API](https://skmtc.dev/flexprice/apis/flexprice-api.md) · [Page](https://skmtc.dev/flexprice/apis/flexprice-api/changes/analytics/query/post)