---
title: "Changes to Create a response"
method: POST
path: "/v1/responses"
---

# Changes to Create a response

`POST /v1/responses`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 17 revisions.

- **2026-08-19** `f66774ddecfc` — 1 info
- **2026-08-13** `d47e1d852549` — 1 breaking
- **2026-08-12** `ff7d87258f32` — 1 breaking, 3 info
- **2026-08-04** `2eece97b5ae5` — 3 breaking, 11 info
- **2026-08-01** `d13e684fd1c9` — 2 info
- **2026-07-31** `c6cc661737c3` — 5 breaking, 19 info
- **2026-07-26** `587cbdf607b0` — 1 info

## Changes

- **2026-08-19** `f66774ddecfc` — 1 info
  - endpoint added
- **2026-08-13** `d47e1d852549` — 1 breaking
  - api path removed without deprecation
- **2026-08-12** `ff7d87258f32` — 1 breaking, 3 info
  - added `#/components/schemas/ReasoningItem, #/components/schemas/SourcesItem` to the `output/items/` response property `oneOf` list for the response status `200`
  - added `reasoning, sources` discriminator mapping keys to the `input/anyOf[subschema #2]/items/` request property
  - added `#/components/schemas/ReasoningItem, #/components/schemas/SourcesItem` to the `input/anyOf[subschema #2]/items/` request property `oneOf` list
  - added `reasoning, sources` discriminator mapping keys to the `output/items/` response property for the response status `200`
- **2026-08-04** `2eece97b5ae5` — 3 breaking, 11 info
  - removed `#/components/schemas/StoreSearchCallItem` from the `input/anyOf[subschema #2]/items/` request property `oneOf` list
  - added `#/components/schemas/StoreGrepTool-Output, #/components/schemas/StoreListChunksTool-Output, #/components/schemas/MetadataFacetsTool-Output` to the `tools/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/StoreSearchCallItem-Output, #/components/schemas/StoreGrepCallItem-Output, #/components/schemas/StoreListChunksCallItem-Output, #/components/schemas/MetadataFacetsCallItem` to the `output/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/ToolChoiceStoreGrep, #/components/schemas/ToolChoiceStoreListChunks, #/components/schemas/ToolChoiceMetadataFacets` to the `tool_choice` request property `anyOf` list
  - added `store_grep, store_list_chunks, store_metadata_facets` discriminator mapping keys to the `tools/items/` request property
  - added `store_grep_call, store_list_chunks_call, store_metadata_facets_call` discriminator mapping keys to the `input/anyOf[subschema #2]/items/` request property
  - mapped value for discriminator key `store_search_call` changed from `#/components/schemas/StoreSearchCallItem` to `#/components/schemas/StoreSearchCallItem-Input` for `input/anyOf[subschema #2]/items/` request property
  - added `#/components/schemas/StoreGrepTool-Input, #/components/schemas/StoreListChunksTool-Input, #/components/schemas/MetadataFacetsTool-Input` to the `tools/items/` request property `oneOf` list
  - added `#/components/schemas/StoreSearchCallItem-Input, #/components/schemas/StoreGrepCallItem-Input, #/components/schemas/StoreListChunksCallItem-Input, #/components/schemas/MetadataFacetsCallItem` to the `input/anyOf[subschema #2]/items/` request property `oneOf` list
  - added `#/components/schemas/ToolChoiceStoreGrep, #/components/schemas/ToolChoiceStoreListChunks, #/components/schemas/ToolChoiceMetadataFacets` to the `tool_choice` response property `anyOf` list for the response status `200`
  - added `store_grep, store_list_chunks, store_metadata_facets` discriminator mapping keys to the `tools/items/` response property for the response status `200`
  - added `store_grep_call, store_list_chunks_call, store_metadata_facets_call` discriminator mapping keys to the `output/items/` response property for the response status `200`
  - mapped value for discriminator key `store_search_call` changed from `#/components/schemas/StoreSearchCallItem` to `#/components/schemas/StoreSearchCallItem-Output` for `output/items/` response property for the response status `200`
  - removed `#/components/schemas/StoreSearchCallItem` from the `output/items/` response property `oneOf` list for the response status `200`
- **2026-08-01** `d13e684fd1c9` — 2 info
  - added the new optional request property `input/anyOf[subschema #2]/items/oneOf[subschema #2: StoreSearchCallItem]/results/anyOf[subschema #1]/items/generated_metadata`
  - added the optional property `output/items/oneOf[subschema #2: StoreSearchCallItem]/results/anyOf[subschema #1]/items/generated_metadata` to the response with the `200` status
- **2026-07-31** `c6cc661737c3` — 5 breaking, 19 info
  - the response property `tools/items/oneOf[subschema #1: StoreSearchTool]/store_identifiers` became optional for the status `200`
  - response property `tools/items/oneOf[subschema #1: StoreSearchTool]/store_identifiers` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added `#/components/schemas/InputImagePart, #/components/schemas/InputFilePart` to the `output/items/oneOf[subschema #1: MessageItem]/content/anyOf[subschema #2]/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/ListStoresCallItem` to the `output/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/ListStoresTool` to the `tools/items/` response property `oneOf` list for the response status `200`
  - added the new optional request property `input/anyOf[subschema #2]/items/oneOf[subschema #2: StoreSearchCallItem]/error`
  - added the new optional request property `input/anyOf[subschema #2]/items/oneOf[subschema #2: StoreSearchCallItem]/store`
  - added the new optional request property `tools/items/oneOf[subschema #1: StoreSearchTool]/enabled`
  - added `#/components/schemas/ToolChoiceListStores` to the `tool_choice` request property `anyOf` list
  - the request property `tools/items/oneOf[subschema #1: StoreSearchTool]/store_identifiers` became optional
  - added `input_file, input_image` discriminator mapping keys to the `input/anyOf[subschema #2]/items/oneOf[subschema #1: MessageItem]/content/anyOf[subschema #2]/items/` request property
  - added `list_stores` discriminator mapping keys to the `tools/items/` request property
  - added `list_stores_call` discriminator mapping keys to the `input/anyOf[subschema #2]/items/` request property
  - request property `tools/items/oneOf[subschema #1: StoreSearchTool]/store_identifiers` list-of-types was widened by adding types `null` to media type `application/json`
  - added `#/components/schemas/InputImagePart, #/components/schemas/InputFilePart` to the `input/anyOf[subschema #2]/items/oneOf[subschema #1: MessageItem]/content/anyOf[subschema #2]/items/` request property `oneOf` list
  - added `#/components/schemas/ListStoresCallItem` to the `input/anyOf[subschema #2]/items/` request property `oneOf` list
  - added `#/components/schemas/ListStoresTool` to the `tools/items/` request property `oneOf` list
  - added the optional property `output/items/oneOf[subschema #2: StoreSearchCallItem]/error` to the response with the `200` status
  - added the optional property `output/items/oneOf[subschema #2: StoreSearchCallItem]/store` to the response with the `200` status
  - added the optional property `tools/items/oneOf[subschema #1: StoreSearchTool]/enabled` to the response with the `200` status
  - added `#/components/schemas/ToolChoiceListStores` to the `tool_choice` response property `anyOf` list for the response status `200`
  - added `input_file, input_image` discriminator mapping keys to the `output/items/oneOf[subschema #1: MessageItem]/content/anyOf[subschema #2]/items/` response property for the response status `200`
  - added `list_stores` discriminator mapping keys to the `tools/items/` response property for the response status `200`
  - added `list_stores_call` discriminator mapping keys to the `output/items/` response property for the response status `200`
- **2026-07-26** `587cbdf607b0` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/mixedbread/apis/mxbai-omni/docs/v1/responses/post.md) · [API](https://skmtc.dev/mixedbread/apis/mxbai-omni.md) · [Page](https://skmtc.dev/mixedbread/apis/mxbai-omni/changes/v1/responses/post)