---
title: "Changes to Create a chat completion"
method: POST
path: "/chat/completions"
---

# Changes to Create a chat completion

`POST /chat/completions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 69 of 303 revisions.

- **2026-09-25** `31b1cd25caca` — 4 info
- **2026-09-24** `4c8b9dc76c45` — 4 info
- **2026-09-24** `2ebaa86f752c` — 1 info
- **2026-09-22** `5f1b1cceea2c` — 2 info
- **2026-09-21** `f72e2b0bf8c6` — 4 info
- **2026-09-17** `3066544509b5` — 3 info
- **2026-09-17** `2de027b6dfcd` — 3 info
- **2026-09-14** `54ab2e9ba857` — 3 info
- **2026-09-09** `5d13b1d2e3ac` — 3 info
- **2026-09-08** `4c62b4e84b28` — 3 breaking
- **2026-09-08** `cfb1900ff6b4` — 1 warning
- **2026-09-08** `4cd0792c1836` — 1 info
- **2026-09-04** `f7fde69f1827` — 1 info
- **2026-09-03** `69fdb8682593` — 3 info
- **2026-09-02** `ec3c432d7820` — 2 info
- **2026-09-02** `2d5e587f8e0e` — 8 info
- **2026-08-31** `89571885f5db` — 2 info
- **2026-08-28** `678cf3543c15` — 3 info
- **2026-08-28** `a5e0686a8308` — 3 info
- **2026-08-25** `9ad72754d740` — 2 info
- **2026-08-25** `0c8071059a0a` — 2 info
- **2026-08-24** `511197dac9f9` — 1 info
- **2026-08-21** `39e93166d6b5` — 3 info
- **2026-08-20** `9bdd97cc37fb` — 8 warning, 4 info
- **2026-08-19** `0100b958c347` — 2 warning
- **2026-08-17** `202407d84d2d` — 2 info
- **2026-08-12** `6869700d8b62` — 4 warning
- **2026-08-11** `c01407ce6d8c` — 3 info
- **2026-08-07** `e95a89c3bb18` — 4 info
- **2026-07-30** `14695c8a78fd` — 1 info
- **2026-07-30** `61e2adc90771` — 3 info
- **2026-07-29** `d4b1ffa2aa94` — 2 info
- **2026-07-28** `dfc92f8f83c8` — 4 info
- **2026-07-27** `6c000cc3a8a3` — 8 warning, 4 info
- **2026-07-27** `0c901f620978` — 3 info
- **2026-07-25** `2db4d2e31592` — 3 info
- **2026-07-25** `d6cf29c1f736` — 3 info
- **2026-07-24** `46e316551165` — 3 info
- **2026-07-24** `f2637b782012` — 3 info
- **2026-07-22** `8c12abc4be80` — 1 info
- **2026-07-22** `a79751dc4b73` — 3 info
- **2026-07-21** `7deea6d04c98` — 3 info
- **2026-07-21** `bdc10facb5b4` — 3 info
- **2026-07-21** `d2b52b844ed1` — 1 info
- **2026-07-17** `ed21cd9d0265` — 3 info
- **2026-07-17** `ea6ed9eed792` — 2 info
- **2026-07-16** `c91cc6f88caa` — 97 breaking, 7 info
- **2026-07-16** `75ebcbc69785` — 8 warning, 4 info
- **2026-07-15** `ada7dbde69ed` — 3 info
- **2026-07-15** `becc20273345` — 1 info
- **2026-07-14** `8b656727d0a3` — 3 info
- **2026-07-14** `10a8039701d3` — 8 info
- **2026-07-13** `9814733ca74d` — 1 breaking, 2 info
- **2026-07-11** `49908263f773` — 3 info
- **2026-07-10** `ce36a3d995b6` — 3 info
- **2026-07-09** `54d88de96c16` — 2 breaking, 4 info
- **2026-07-08** `1ea08212e713` — 1 info
- **2026-07-06** `61a7c96ef42f` — 1 info
- **2026-07-01** `25d1c343bfe1` — 1 info
- **2026-06-28** `654dd48df2fd` — 1 warning, 3 info
- **2026-06-26** `7fd444475582` — 3 info
- **2026-06-25** `65d868cedd4e` — 4 breaking, 4 warning
- **2026-06-24** `1de249ed4255` — 3 info
- **2026-06-24** `8758fa27fe84` — 4 info
- **2026-06-24** `bae0fe0fb859` — 3 info
- **2026-06-23** `947294ecfa77` — 3 info
- **2026-06-23** `b73e9d7306a8` — 1 info
- **2026-06-22** `8d4d6fd85671` — 4 info
- **2026-06-18** `8a4d74c0c61d` — 2 info

## Changes

- **2026-09-25** `31b1cd25caca` — 4 info
  - added the new optional request property `provider/options/respan`
  - added the new `Respan` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Respan` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Respan` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-09-24** `4c8b9dc76c45` — 4 info
  - added the new optional request property `provider/options/scaledown`
  - added the new `ScaleDown` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `ScaleDown` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `ScaleDown` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-09-24** `2ebaa86f752c` — 1 info
  - added the new optional request property `provider/options`
- **2026-09-22** `5f1b1cceea2c` — 2 info
  - added `switchyard-router` discriminator mapping keys to the `plugins/items/` request property
  - added `#/components/schemas/SwitchyardRouterPlugin` to the `plugins/items/` request property `oneOf` list
- **2026-09-21** `f72e2b0bf8c6` — 4 info
  - added the new optional request property `plugins/items/oneOf[#/components/schemas/WebSearchPlugin]/x_search`
  - added the new optional request property `tools/items/anyOf[#/components/schemas/ChatWebSearchShorthand]/parameters/x_search`
  - added the new optional request property `tools/items/anyOf[#/components/schemas/ChatWebSearchShorthand]/x_search`
  - added the new optional request property `tools/items/anyOf[#/components/schemas/OpenRouterWebSearchServerTool]/parameters/x_search`
- **2026-09-17** `3066544509b5` — 3 info
  - added the new `Unbiased` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Unbiased` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Unbiased` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-09-17** `2de027b6dfcd` — 3 info
  - added the new `TypeSafe` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `TypeSafe` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `TypeSafe` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-09-14** `54ab2e9ba857` — 3 info
  - added the new `AssemblyAI` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `AssemblyAI` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `AssemblyAI` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-09-09** `5d13b1d2e3ac` — 3 info
  - added the new `Near AI` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Near AI` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Near AI` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-09-08** `4c62b4e84b28` — 3 breaking
  - removed the enum value `NCompass` of the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - removed the enum value `NCompass` of the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - removed the enum value `NCompass` of the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-09-08** `cfb1900ff6b4` — 1 warning
  - removed the request property `tools/items/anyOf[#/components/schemas/BashServerTool]/parameters/sleep_after_seconds`
- **2026-09-08** `4cd0792c1836` — 1 info
  - added the new optional request property `messages/items/oneOf[#/components/schemas/ChatDeveloperMessage]/configuration_update`
- **2026-09-04** `f7fde69f1827` — 1 info
  - added the new optional request property `messages/items/oneOf[#/components/schemas/ChatSystemMessage]/configuration_update`
- **2026-09-03** `69fdb8682593` — 3 info
  - added the new `PrimeIntellect` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `PrimeIntellect` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `PrimeIntellect` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-09-02** `ec3c432d7820` — 2 info
  - added the optional property `data/openrouter_metadata/generation_time` to the response with the `200` status (media type: text/event-stream)
  - added the optional property `openrouter_metadata/generation_time` to the response with the `200` status (media type: application/json)
- **2026-09-02** `2d5e587f8e0e` — 8 info
  - added the new optional request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/content/anyOf[subschema #2]/items/oneOf[#/components/schemas/ChatContentVideo]/video_url/processing`
  - added the new optional request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/content/anyOf[subschema #2]/items/oneOf[#/components/schemas/Legacy_ChatContentVideo]/video_url/processing`
  - added the new optional request property `messages/items/oneOf[#/components/schemas/ChatToolMessage]/content/anyOf[subschema #2]/items/oneOf[#/components/schemas/ChatContentVideo]/video_url/processing`
  - added the new optional request property `messages/items/oneOf[#/components/schemas/ChatToolMessage]/content/anyOf[subschema #2]/items/oneOf[#/components/schemas/Legacy_ChatContentVideo]/video_url/processing`
  - added the new optional request property `messages/items/oneOf[#/components/schemas/ChatUserMessage]/content/anyOf[subschema #2]/items/oneOf[#/components/schemas/ChatContentVideo]/video_url/processing`
  - added the new optional request property `messages/items/oneOf[#/components/schemas/ChatUserMessage]/content/anyOf[subschema #2]/items/oneOf[#/components/schemas/Legacy_ChatContentVideo]/video_url/processing`
  - added the optional property `choices/items/message/content/anyOf[subschema #2]/items/oneOf[#/components/schemas/ChatContentVideo]/video_url/processing` to the response with the `200` status
  - added the optional property `choices/items/message/content/anyOf[subschema #2]/items/oneOf[#/components/schemas/Legacy_ChatContentVideo]/video_url/processing` to the response with the `200` status
- **2026-08-31** `89571885f5db` — 2 info
  - added the optional property `data/usage/cost_details/server_tool_cost` to the response with the `200` status (media type: text/event-stream)
  - added the optional property `usage/cost_details/server_tool_cost` to the response with the `200` status (media type: application/json)
- **2026-08-28** `678cf3543c15` — 3 info
  - added the new `Cosine` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Cosine` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Cosine` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-08-28** `a5e0686a8308` — 3 info
  - added the new `Ollama` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Ollama` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Ollama` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-08-25** `9ad72754d740` — 2 info
  - added the new optional request property `tools/items/anyOf[#/components/schemas/BashServerTool]/parameters/environment/oneOf[#/components/schemas/ContainerAutoEnvironment]/file_ids`
  - added the new optional request property `tools/items/anyOf[#/components/schemas/BashServerTool]/parameters/environment/oneOf[#/components/schemas/ContainerReferenceEnvironment]/file_ids`
- **2026-08-25** `0c8071059a0a` — 2 info
  - added the new optional request property `tools/items/anyOf[#/components/schemas/BashServerTool]/parameters/environment/oneOf[#/components/schemas/ContainerAutoEnvironment]/network_policy`
  - added the new optional request property `tools/items/anyOf[#/components/schemas/BashServerTool]/parameters/environment/oneOf[#/components/schemas/ContainerReferenceEnvironment]/network_policy`
- **2026-08-24** `511197dac9f9` — 1 info
  - the `tools/items/anyOf[#/components/schemas/BashServerTool]/parameters/environment/oneOf[#/components/schemas/ContainerReferenceEnvironment]/container_id` request property's maxLength was increased from `20` to `40`
- **2026-08-21** `39e93166d6b5` — 3 info
  - added the new `Makora` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Makora` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Makora` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-08-20** `9bdd97cc37fb` — 8 warning, 4 info
  - added the new `bedrock-xai-responses-v1` enum value to the `choices/items/message/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailEncrypted]/format` response property for the response status `200` (media type: application/json)
  - added the new `bedrock-xai-responses-v1` enum value to the `choices/items/message/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailServerToolCall]/format` response property for the response status `200` (media type: application/json)
  - added the new `bedrock-xai-responses-v1` enum value to the `choices/items/message/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailSummary]/format` response property for the response status `200` (media type: application/json)
  - added the new `bedrock-xai-responses-v1` enum value to the `choices/items/message/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailText]/format` response property for the response status `200` (media type: application/json)
  - added the new `bedrock-xai-responses-v1` enum value to the `data/choices/items/delta/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailEncrypted]/format` response property for the response status `200` (media type: text/event-stream)
  - added the new `bedrock-xai-responses-v1` enum value to the `data/choices/items/delta/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailServerToolCall]/format` response property for the response status `200` (media type: text/event-stream)
  - added the new `bedrock-xai-responses-v1` enum value to the `data/choices/items/delta/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailSummary]/format` response property for the response status `200` (media type: text/event-stream)
  - added the new `bedrock-xai-responses-v1` enum value to the `data/choices/items/delta/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailText]/format` response property for the response status `200` (media type: text/event-stream)
  - added the new `bedrock-xai-responses-v1` enum value to the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailEncrypted]/format`
  - added the new `bedrock-xai-responses-v1` enum value to the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailServerToolCall]/format`
  - added the new `bedrock-xai-responses-v1` enum value to the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailSummary]/format`
  - added the new `bedrock-xai-responses-v1` enum value to the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailText]/format`
- **2026-08-19** `0100b958c347` — 2 warning
  - removed the request property `tools/items/anyOf[#/components/schemas/AdvisorServerTool_OpenRouter]/parameters/max_tool_calls`
  - removed the request property `tools/items/anyOf[#/components/schemas/AdvisorServerTool_OpenRouter]/parameters/tools`
- **2026-08-17** `202407d84d2d` — 2 info
  - added the new optional request property `tools/items/anyOf[#/components/schemas/SubagentServerTool_OpenRouter]/parameters/inherit_functions`
  - added the new optional request property `tools/items/anyOf[#/components/schemas/SubagentServerTool_OpenRouter]/parameters/inherited_function_names`
- **2026-08-12** `6869700d8b62` — 4 warning
  - the `plugins/items/oneOf[#/components/schemas/AutoBetaRouterPlugin]/allowed_models/items/` request property's maxLength was set to `1024`
  - the `plugins/items/oneOf[#/components/schemas/AutoBetaRouterPlugin]/excluded_models/items/` request property's maxLength was set to `1024`
  - the `plugins/items/oneOf[#/components/schemas/AutoRouterPlugin]/allowed_models/items/` request property's maxLength was set to `1024`
  - the `plugins/items/oneOf[#/components/schemas/AutoRouterPlugin]/excluded_models/items/` request property's maxLength was set to `1024`
- **2026-08-11** `c01407ce6d8c` — 3 info
  - added the new `Databricks` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Databricks` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Databricks` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-08-07** `e95a89c3bb18` — 4 info
  - added the new optional request property `plugins/items/oneOf[#/components/schemas/WebSearchPlugin]/mode`
  - added the new optional request property `tools/items/anyOf[#/components/schemas/ChatWebSearchShorthand]/mode`
  - added the new optional request property `tools/items/anyOf[#/components/schemas/ChatWebSearchShorthand]/parameters/mode`
  - added the new optional request property `tools/items/anyOf[#/components/schemas/OpenRouterWebSearchServerTool]/parameters/mode`
- **2026-07-30** `14695c8a78fd` — 1 info
  - added the new `fast` enum value to the request property `service_tier`
- **2026-07-30** `61e2adc90771` — 3 info
  - added the new `Thinking Machines` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Thinking Machines` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Thinking Machines` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-07-29** `d4b1ffa2aa94` — 2 info
  - added the new optional request property `plugins/items/oneOf[#/components/schemas/AutoBetaRouterPlugin]/excluded_models`
  - added the new optional request property `plugins/items/oneOf[#/components/schemas/AutoRouterPlugin]/excluded_models`
- **2026-07-28** `dfc92f8f83c8` — 4 info
  - added the new optional request property `plugins/items/oneOf[#/components/schemas/AutoBetaRouterPlugin]/cost_tier`
  - added the new optional request property `plugins/items/oneOf[#/components/schemas/AutoRouterPlugin]/cost_tier`
  - request property `plugins/items/oneOf[#/components/schemas/AutoBetaRouterPlugin]/cost_quality_tradeoff` deprecated
  - request property `plugins/items/oneOf[#/components/schemas/AutoRouterPlugin]/cost_quality_tradeoff` deprecated
- **2026-07-27** `6c000cc3a8a3` — 8 warning, 4 info
  - added the new `bedrock-openai-responses-v1` enum value to the `choices/items/message/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailEncrypted]/format` response property for the response status `200` (media type: application/json)
  - added the new `bedrock-openai-responses-v1` enum value to the `choices/items/message/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailServerToolCall]/format` response property for the response status `200` (media type: application/json)
  - added the new `bedrock-openai-responses-v1` enum value to the `choices/items/message/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailSummary]/format` response property for the response status `200` (media type: application/json)
  - added the new `bedrock-openai-responses-v1` enum value to the `choices/items/message/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailText]/format` response property for the response status `200` (media type: application/json)
  - added the new `bedrock-openai-responses-v1` enum value to the `data/choices/items/delta/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailEncrypted]/format` response property for the response status `200` (media type: text/event-stream)
  - added the new `bedrock-openai-responses-v1` enum value to the `data/choices/items/delta/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailServerToolCall]/format` response property for the response status `200` (media type: text/event-stream)
  - added the new `bedrock-openai-responses-v1` enum value to the `data/choices/items/delta/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailSummary]/format` response property for the response status `200` (media type: text/event-stream)
  - added the new `bedrock-openai-responses-v1` enum value to the `data/choices/items/delta/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailText]/format` response property for the response status `200` (media type: text/event-stream)
  - added the new `bedrock-openai-responses-v1` enum value to the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailEncrypted]/format`
  - added the new `bedrock-openai-responses-v1` enum value to the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailServerToolCall]/format`
  - added the new `bedrock-openai-responses-v1` enum value to the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailSummary]/format`
  - added the new `bedrock-openai-responses-v1` enum value to the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailText]/format`
- **2026-07-27** `0c901f620978` — 3 info
  - added the new `mxfp4` enum value to the request property `provider/quantizations/items/`
  - added the new `mxfp8` enum value to the request property `provider/quantizations/items/`
  - added the new `nvfp4` enum value to the request property `provider/quantizations/items/`
- **2026-07-25** `2db4d2e31592` — 3 info
  - added the new `Modal` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Modal` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Modal` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-07-25** `d6cf29c1f736` — 3 info
  - added the new `Claude Platform on AWS` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Claude Platform on AWS` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Claude Platform on AWS` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-07-24** `46e316551165` — 3 info
  - added the new `VoyageAI by MongoDB` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `VoyageAI by MongoDB` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `VoyageAI by MongoDB` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-07-24** `f2637b782012` — 3 info
  - added the new optional request property `tools/items/anyOf[#/components/schemas/ChatWebSearchShorthand]/max_uses`
  - added the new optional request property `tools/items/anyOf[#/components/schemas/ChatWebSearchShorthand]/parameters/max_uses`
  - added the new optional request property `tools/items/anyOf[#/components/schemas/OpenRouterWebSearchServerTool]/parameters/max_uses`
- **2026-07-22** `8c12abc4be80` — 1 info
  - added the new optional request property `plugins/items/oneOf[#/components/schemas/ParetoRouterPlugin]/max_price`
- **2026-07-22** `a79751dc4b73` — 3 info
  - added the new optional request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/model`
  - added the new optional request property `plugins/items/oneOf[#/components/schemas/AutoRouterPlugin]/pin_model`
  - added the optional property `choices/items/message/model` to the response with the `200` status
- **2026-07-21** `7deea6d04c98` — 3 info
  - added the new `CoreWeave` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `CoreWeave` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `CoreWeave` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-07-21** `bdc10facb5b4` — 3 info
  - added the new `Runway` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Runway` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Runway` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-07-21** `d2b52b844ed1` — 1 info
  - added the new optional request property `tools/items/anyOf[#/components/schemas/SubagentServerTool_OpenRouter]/parameters/name`
- **2026-07-17** `ed21cd9d0265` — 3 info
  - added the new `Fish Audio` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Fish Audio` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Fish Audio` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-07-17** `ea6ed9eed792` — 2 info
  - added `auto-beta-router` discriminator mapping keys to the `plugins/items/` request property
  - added `#/components/schemas/AutoBetaRouterPlugin` to the `plugins/items/` request property `oneOf` list
- **2026-07-16** `c91cc6f88caa` — 97 breaking, 7 info
  - removed `subschema #2, subschema #3` from the `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/content` request property `anyOf` list
  - removed `subschema #4, subschema #5, subschema #6, subschema #7` from the `plugins/items/oneOf[#/components/schemas/FusionPlugin]/tools/items/parameters/additionalProperties/` request property `anyOf` list
  - the request property `frequency_penalty` became not nullable
  - the request property `image_config/additionalProperties/anyOf[subschema #3]/items/` became not nullable
  - the request property `logit_bias` became not nullable
  - the request property `logprobs` became not nullable
  - the request property `max_completion_tokens` became not nullable
  - the request property `max_tokens` became not nullable
  - the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning` became not nullable
  - the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailEncrypted]/format` became not nullable
  - the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailEncrypted]/id` became not nullable
  - the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailServerToolCall]/format` became not nullable
  - the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailServerToolCall]/id` became not nullable
  - the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailServerToolCall]/tool_call_id` became not nullable
  - the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailSummary]/format` became not nullable
  - the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailSummary]/id` became not nullable
  - the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailText]/format` became not nullable
  - the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailText]/id` became not nullable
  - the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailText]/signature` became not nullable
  - the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailText]/text` became not nullable
  - the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/refusal` became not nullable
  - the request property `messages/items/oneOf[#/components/schemas/ChatDeveloperMessage]/content/anyOf[subschema #2]/items/prompt_cache_breakpoint` became not nullable
  - the request property `messages/items/oneOf[#/components/schemas/ChatSystemMessage]/content/anyOf[subschema #2]/items/prompt_cache_breakpoint` became not nullable
  - the request property `messages/items/oneOf[#/components/schemas/ChatToolMessage]/content/anyOf[subschema #2]/items/oneOf[#/components/schemas/ChatContentText]/prompt_cache_breakpoint` became not nullable
  - the request property `messages/items/oneOf[#/components/schemas/ChatUserMessage]/content/anyOf[subschema #2]/items/oneOf[#/components/schemas/ChatContentText]/prompt_cache_breakpoint` became not nullable
  - the request property `min_p` became not nullable
  - the request property `parallel_tool_calls` became not nullable
  - the request property `plugins/items/oneOf[#/components/schemas/WebSearchPlugin]/user_location/allOf[#/components/schemas/WebSearchUserLocation]/` became not nullable
  - the request property `plugins/items/oneOf[#/components/schemas/WebSearchPlugin]/user_location/allOf[#/components/schemas/WebSearchUserLocation]/city` became not nullable
  - the request property `plugins/items/oneOf[#/components/schemas/WebSearchPlugin]/user_location/allOf[#/components/schemas/WebSearchUserLocation]/country` became not nullable
  - the request property `plugins/items/oneOf[#/components/schemas/WebSearchPlugin]/user_location/allOf[#/components/schemas/WebSearchUserLocation]/region` became not nullable
  - the request property `plugins/items/oneOf[#/components/schemas/WebSearchPlugin]/user_location/allOf[#/components/schemas/WebSearchUserLocation]/timezone` became not nullable
  - the request property `prediction` became not nullable
  - the request property `presence_penalty` became not nullable
  - the request property `prompt_cache_key` became not nullable
  - the request property `prompt_cache_options` became not nullable
  - the request property `prompt_cache_options/ttl` became not nullable
  - the request property `provider` became not nullable
  - the request property `provider/allow_fallbacks` became not nullable
  - the request property `provider/data_collection` became not nullable
  - …64 more
- **2026-07-16** `75ebcbc69785` — 8 warning, 4 info
  - added the new `meta-responses-v1` enum value to the `choices/items/message/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailEncrypted]/format` response property for the response status `200` (media type: application/json)
  - added the new `meta-responses-v1` enum value to the `choices/items/message/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailServerToolCall]/format` response property for the response status `200` (media type: application/json)
  - added the new `meta-responses-v1` enum value to the `choices/items/message/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailSummary]/format` response property for the response status `200` (media type: application/json)
  - added the new `meta-responses-v1` enum value to the `choices/items/message/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailText]/format` response property for the response status `200` (media type: application/json)
  - added the new `meta-responses-v1` enum value to the `data/choices/items/delta/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailEncrypted]/format` response property for the response status `200` (media type: text/event-stream)
  - added the new `meta-responses-v1` enum value to the `data/choices/items/delta/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailServerToolCall]/format` response property for the response status `200` (media type: text/event-stream)
  - added the new `meta-responses-v1` enum value to the `data/choices/items/delta/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailSummary]/format` response property for the response status `200` (media type: text/event-stream)
  - added the new `meta-responses-v1` enum value to the `data/choices/items/delta/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailText]/format` response property for the response status `200` (media type: text/event-stream)
  - added the new `meta-responses-v1` enum value to the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailEncrypted]/format`
  - added the new `meta-responses-v1` enum value to the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailServerToolCall]/format`
  - added the new `meta-responses-v1` enum value to the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailSummary]/format`
  - added the new `meta-responses-v1` enum value to the request property `messages/items/oneOf[#/components/schemas/ChatAssistantMessage]/reasoning_details/items/oneOf[#/components/schemas/ReasoningDetailText]/format`
- **2026-07-15** `ada7dbde69ed` — 3 info
  - added the new `Krea` enum value to the request property `provider/ignore/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Krea` enum value to the request property `provider/only/items/anyOf[#/components/schemas/ProviderName]/`
  - added the new `Krea` enum value to the request property `provider/order/items/anyOf[#/components/schemas/ProviderName]/`
- **2026-07-15** `becc20273345` — 1 info
  - added the new optional request property `prediction`
- …earlier changes are on the page: https://skmtc.dev/openrouterteam/apis/openrouter-api/changes/chat/completions/post

---

[Operation](https://skmtc.dev/openrouterteam/apis/openrouter-api/docs/chat/completions/post.md) · [API](https://skmtc.dev/openrouterteam/apis/openrouter-api.md) · [Page](https://skmtc.dev/openrouterteam/apis/openrouter-api/changes/chat/completions/post)
