---
title: "Changes to Generate query from natural language"
method: POST
path: "/api/v1/ai/generate-query"
---

# Changes to Generate query from natural language

`POST /api/v1/ai/generate-query`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 97 revisions.

- **2026-10-23** `62e1e8d26081`: 1 info
- **2026-10-22** `fbe772c8710f`: 5 info
- **2026-10-21** `576d1bf4c442`: 1 info
- **2026-10-21** `28267e966a8c`: 1 info
- **2026-10-20** `6c4d2316e1f2`: 4 info
- **2026-09-09** `c1adb617d077`: 1 info

## Changes

- **2026-10-23** `62e1e8d26081`: 1 info
  - added the new optional request property `allOf[subschema #2]/documentQueries/items/appPhase`
- **2026-10-22** `fbe772c8710f`: 5 info
  - added the new optional request property `allOf[subschema #2]/contextQuery`
  - added the new optional request property `allOf[subschema #2]/documentQueries`
  - the request property `allOf[subschema #2]/prompt` became optional
  - the `prompt` request property default value `` was added
  - the `allOf[#/components/schemas/AiTopicParams]/branchId` request property format was generalized from `uuid` to no format
- **2026-10-21** `576d1bf4c442`: 1 info
  - added the new `baseten_managed` enum value to the request property `allOf[subschema #2]/requestedLlm/provider`
- **2026-10-21** `28267e966a8c`: 1 info
  - added the new `databricks_managed` enum value to the request property `allOf[subschema #2]/requestedLlm/provider`
- **2026-10-20** `6c4d2316e1f2`: 4 info
  - added the new optional request property `allOf[subschema #2]/requestedLlm`
  - added the non-success response with the status `422`
  - added the optional property `downgradedLlm` to the response with the `200` status
  - response property `downgradedModelTier` deprecated
- **2026-09-09** `c1adb617d077`: 1 info
  - added the optional property `rowLimitHit` to the response with the `200` status

---

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