---
title: "Changes to Execute a semantic query"
method: POST
path: "/api/v1/query/run"
---

# Changes to Execute a semantic query

`POST /api/v1/query/run`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 97 revisions.

- **2026-10-16** `12e9325d71cd`: 1 breaking, 1 info
- **2026-10-15** `f9d898b7238c`: 4 breaking, 18 info
- **2026-10-07** `1928c8cc5ec5`: 6 info
- **2026-09-15** `febf0a61f153`: 4 breaking, 5 info
- **2026-07-26** `f65b6ea0a62f`: 1 breaking, 3 warning, 4 info

## Changes

- **2026-10-16** `12e9325d71cd`: 1 breaking, 1 info
  - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7, subschema #8` from the `query/filters/additionalProperties/` request property `oneOf` list
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7, subschema #8` to the `query/filters/additionalProperties/` request property `oneOf` list
- **2026-10-15** `f9d898b7238c`: 4 breaking, 18 info
  - added the new required request property `query/fields`
  - added the new required request property `query/modelId`
  - the request property `query` became required
  - the `query` request property type changed from no type to `object`
  - added the new optional request property `query/calculations`
  - added the new optional request property `query/column_limit`
  - added the new optional request property `query/column_totals`
  - added the new optional request property `query/custom_summary_types`
  - added the new optional request property `query/default_group_by`
  - added the new optional request property `query/fill_fields`
  - added the new optional request property `query/filters`
  - added the new optional request property `query/join_paths_from_topic_name`
  - added the new optional request property `query/join_via_map`
  - added the new optional request property `query/limit`
  - added the new optional request property `query/model_extension_id`
  - added the new optional request property `query/offset`
  - added the new optional request property `query/period_over_period_computations`
  - added the new optional request property `query/pivots`
  - added the new optional request property `query/row_totals`
  - added the new optional request property `query/sorts`
  - added the new optional request property `query/table`
  - added the new optional request property `query/transposed_measures`
- **2026-10-07** `1928c8cc5ec5`: 6 info
  - added the new optional request property `completionOnly`
  - added the optional property `anyOf[#/components/schemas/QueryStreamJobLine]/stream_stats/bytes` to the response with the `200` status
  - added the optional property `anyOf[#/components/schemas/QueryStreamJobLine]/stream_stats/next_offset` to the response with the `200` status
  - added the optional property `anyOf[#/components/schemas/QueryStreamJobLine]/stream_stats/offset` to the response with the `200` status
  - added the optional property `anyOf[#/components/schemas/QueryStreamJobLine]/stream_stats/server_stream` to the response with the `200` status
  - added the optional property `anyOf[#/components/schemas/QueryStreamJobLine]/stream_stats/total_bytes` to the response with the `200` status
- **2026-09-15** `febf0a61f153`: 4 breaking, 5 info
  - removed the enum value `disabled` of the request property `cache`
  - removed the enum value `normal` of the request property `cache`
  - removed the enum value `refresh` of the request property `cache`
  - removed the enum value `refresh_all` of the request property `cache`
  - added the new optional request property `timezone`
  - added the new `SkipCache` enum value to the request property `cache`
  - added the new `SkipCacheAndRebuildExtracts` enum value to the request property `cache`
  - added the new `SkipRequery` enum value to the request property `cache`
  - added the new `Standard` enum value to the request property `cache`
- **2026-07-26** `f65b6ea0a62f`: 1 breaking, 3 warning, 4 info
  - the response's body type changed from `object` to `array` for status `200`
  - removed the optional property `completedQueries` from the response with the `200` status
  - removed the optional property `jobIds` from the response with the `200` status
  - removed the optional property `plan` from the response with the `200` status
  - added the new optional request property `workbookUrl`
  - added the media type `application/vnd.ms-excel` for the response with the status `200`
  - added the media type `text/csv` for the response with the status `200`
  - added the media type `text/ndjson` for the response with the status `200`

---

[Operation](https://skmtc.dev/omniapp/apis/omni-api/docs/api/v1/query/run/post.md) - [API](https://skmtc.dev/omniapp/apis/omni-api.md) - [Page](https://skmtc.dev/omniapp/apis/omni-api/changes/api/v1/query/run/post)