--- title: "Changes to Creates a model response for the given chat conversation." method: POST path: "/openai/v1/chat/completions" --- # Changes to Creates a model response for the given chat conversation. `POST /openai/v1/chat/completions` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 31 of 43 revisions. - **2026-06-21** `ea91f46f212a` — 2 breaking, 2 info - **2025-11-26** `aa20a6b53361` — 2 info - **2025-11-18** `b059caa2a4d4` — 7 info - **2025-11-12** `5d2697ad30cc` — 1 info - **2025-10-21** `498dee72535c` — 1 breaking, 2 warning, 3 info - **2025-09-27** `33d547833ca3` — 3 info - **2025-09-04** `7b46be9995c0` — 3 breaking, 10 info - **2025-09-02** `a95a90928412` — 7 breaking, 8 info - **2025-08-05** `4543b558a0a5` — 3 breaking, 6 info - **2025-07-23** `df1532d12363` — 1 info - **2025-07-11** `f687d041a4a8` — 4 info - **2025-06-25** `1cdb4a5cd727` — 1 info - **2025-06-12** `ea5b03626ef6` — 14 info - **2025-06-11** `d6462cdccc87` — 2 info - **2025-05-29** `a2ddf0c5cb79` — 1 info - **2025-05-16** `ee34f94100e3` — 1 breaking, 1 warning, 5 info - **2025-05-02** `e4cd6fe4e6ac` — 2 info - **2025-04-22** `37498d19ece8` — 2 breaking, 6 info - **2025-04-01** `8d531e091886` — 2 info - **2025-02-03** `d1588e103a6a` — 1 info - **2025-01-29** `c5b2589925cd` — 1 info - **2025-01-11** `8bf31041292f` — 2 info - **2025-01-09** `33be0d612b9f` — 1 info - **2025-01-08** `b33d3547dd14` — 1 info - **2024-08-27** `1f0d266ba97b` — 6 warning - **2024-06-26** `f2c71038b5ac` — 1 info - **2024-06-26** `d9cb66d87629` — 7 info - **2024-05-25** `a4c1214ecaa2` — 1 breaking, 3 info - **2024-05-22** `0f93f9ac6d4a` — 12 breaking, 14 warning, 32 info - **2024-05-21** `45aff5d28bf6` — 6 breaking, 17 warning, 26 info - **2024-05-16** `4643bbeed705` — 1 info ## Changes - **2026-06-21** `ea91f46f212a` — 2 breaking, 2 info - the `usage_breakdown` response's property type changed from `object` to no type for status `200` - removed the required property `usage_breakdown/models` from the response with the `200` status - added the new `qwen/qwen3.6-27b` enum value to the request property `model/anyOf[subschema #2]/` - added `#/components/schemas/ChatCompletionUsageBreakdown` to the `usage_breakdown` response property `allOf` list for the response status `200` - **2025-11-26** `aa20a6b53361` — 2 info - added `#/components/schemas/ChatCompletionRequestMessageContentPartDocument` to the `messages/items/oneOf[subschema #2: User message]/content/oneOf[subschema #2: Array of content parts]/items/` request property `oneOf` list - added `#/components/schemas/ChatCompletionRequestMessageContentPartDocument` to the `messages/items/oneOf[subschema #4: Tool message]/content/oneOf[subschema #2: Array of content parts]/items/` request property `oneOf` list - **2025-11-18** `b059caa2a4d4` — 7 info - added the optional property `mcp_list_tools` to the response with the `200` status - added the optional property `service_tier` to the response with the `200` status - added the optional property `usage/completion_tokens_details` to the response with the `200` status - added the optional property `usage/prompt_tokens_details` to the response with the `200` status - added the optional property `usage_breakdown/models/items/usage/completion_tokens_details` to the response with the `200` status - added the optional property `usage_breakdown/models/items/usage/prompt_tokens_details` to the response with the `200` status - added the optional property `x_groq` to the response with the `200` status - **2025-11-12** `5d2697ad30cc` — 1 info - added the optional property `choices/items/message/annotations` to the response with the `200` status - **2025-10-21** `498dee72535c` — 1 breaking, 2 warning, 3 info - added the new required request property `documents/items/source` - removed the request property `documents/items/text` - removed the request property `enable_citations` - added the new optional request property `citation_options` - added the new optional request property `documents/items/id` - added the optional property `choices/items/message/executed_tools/items/browser_results` to the response with the `200` status - **2025-09-27** `33d547833ca3` — 3 info - added the new optional request property `disable_tool_validation` - added the new optional request property `enable_citations` - added the new optional request property `tools/items/function/strict` - **2025-09-04** `7b46be9995c0` — 3 breaking, 10 info - removed the enum value `llama-guard-3-8b` of the request property `model/anyOf[subschema #2]/` - removed the enum value `llama3-70b-8192` of the request property `model/anyOf[subschema #2]/` - removed the enum value `llama3-8b-8192` of the request property `model/anyOf[subschema #2]/` - added the new optional request property `compound_custom/tools` - added the new `compound-beta` enum value to the request property `model/anyOf[subschema #2]/` - added the new `compound-beta-mini` enum value to the request property `model/anyOf[subschema #2]/` - added the new `meta-llama/llama-4-maverick-17b-128e-instruct` enum value to the request property `model/anyOf[subschema #2]/` - added the new `meta-llama/llama-4-scout-17b-16e-instruct` enum value to the request property `model/anyOf[subschema #2]/` - added the new `meta-llama/llama-guard-4-12b` enum value to the request property `model/anyOf[subschema #2]/` - added the new `moonshotai/kimi-k2-instruct` enum value to the request property `model/anyOf[subschema #2]/` - added the new `openai/gpt-oss-120b` enum value to the request property `model/anyOf[subschema #2]/` - added the new `openai/gpt-oss-20b` enum value to the request property `model/anyOf[subschema #2]/` - added the new `qwen/qwen3-32b` enum value to the request property `model/anyOf[subschema #2]/` - **2025-09-02** `a95a90928412` — 7 breaking, 8 info - removed `subschema #1` from the `reasoning_effort` request property `anyOf` list - request property `reasoning_effort` was restricted to a list of enum values - removed the enum value `browser_search` of the request property `tools/items/type` - removed the enum value `code_interpreter` of the request property `tools/items/type` - removed the enum value `function` of the request property `tools/items/type` - the `reasoning_effort` request property type changed from no type to `string` - the `tools/items/type` request property type changed from `string` to no type - added the new optional request property `compound_custom` - added the new optional request property `documents` - added `subschema #1, subschema #2` to the `tools/items/type` request property `anyOf` list - added the new `default` enum value to the request property `reasoning_effort` - added the new `high` enum value to the request property `reasoning_effort` - added the new `low` enum value to the request property `reasoning_effort` - added the new `medium` enum value to the request property `reasoning_effort` - added the new `none` enum value to the request property `reasoning_effort` - **2025-08-05** `4543b558a0a5` — 3 breaking, 6 info - removed the enum value `default` of the request property `reasoning_effort` - removed the enum value `none` of the request property `reasoning_effort` - the `reasoning_effort` request property type changed from `string` to no type - added the new optional request property `include_reasoning` - added `subschema #1` to the `reasoning_effort` request property `anyOf` list - added `developer` discriminator mapping keys to the `messages/items/` request property - added the new `browser_search` enum value to the request property `tools/items/type` - added the new `code_interpreter` enum value to the request property `tools/items/type` - added the new `developer` enum value to the request property `messages/items/oneOf[subschema #1: System message]/role` - **2025-07-23** `df1532d12363` — 1 info - the request property `tools/items/function` became optional - **2025-07-11** `f687d041a4a8` — 4 info - added the new `performance` enum value to the request property `service_tier` - request property `messages/items/oneOf[subschema #1: System message]/content` list-of-types was widened by adding types `array` to media type `application/json` - request property `messages/items/oneOf[subschema #3: Assistant message]/content` list-of-types was widened by adding types `array` to media type `application/json` - request property `messages/items/oneOf[subschema #4: Tool message]/content` list-of-types was widened by adding types `array` to media type `application/json` - **2025-06-25** `1cdb4a5cd727` — 1 info - added the new optional request property `search_settings/country` - **2025-06-12** `ea5b03626ef6` — 14 info - added the new optional request property `messages/items/oneOf[subschema #3: Assistant message]/reasoning` - added the new optional request property `reasoning_effort` - added the optional property `choices/items/message/executed_tools/items/code_results/items/chart/elements/items/first_quartile` to the response with the `200` status - added the optional property `choices/items/message/executed_tools/items/code_results/items/chart/elements/items/max` to the response with the `200` status - added the optional property `choices/items/message/executed_tools/items/code_results/items/chart/elements/items/median` to the response with the `200` status - added the optional property `choices/items/message/executed_tools/items/code_results/items/chart/elements/items/min` to the response with the `200` status - added the optional property `choices/items/message/executed_tools/items/code_results/items/chart/elements/items/outliers` to the response with the `200` status - added the optional property `choices/items/message/executed_tools/items/code_results/items/chart/elements/items/third_quartile` to the response with the `200` status - added the optional property `choices/items/message/executed_tools/items/code_results/items/charts/items/elements/items/first_quartile` to the response with the `200` status - added the optional property `choices/items/message/executed_tools/items/code_results/items/charts/items/elements/items/max` to the response with the `200` status - added the optional property `choices/items/message/executed_tools/items/code_results/items/charts/items/elements/items/median` to the response with the `200` status - added the optional property `choices/items/message/executed_tools/items/code_results/items/charts/items/elements/items/min` to the response with the `200` status - added the optional property `choices/items/message/executed_tools/items/code_results/items/charts/items/elements/items/outliers` to the response with the `200` status - added the optional property `choices/items/message/executed_tools/items/code_results/items/charts/items/elements/items/third_quartile` to the response with the `200` status - **2025-06-11** `d6462cdccc87` — 2 info - added the optional property `choices/items/message/executed_tools/items/code_results/items/chart` to the response with the `200` status - added the optional property `choices/items/message/executed_tools/items/code_results/items/charts` to the response with the `200` status - **2025-05-29** `a2ddf0c5cb79` — 1 info - added the optional property `choices/items/message/executed_tools/items/code_results` to the response with the `200` status - **2025-05-16** `ee34f94100e3` — 1 breaking, 1 warning, 5 info - the `response_format` request property type changed from `object` to no type - removed the request property `response_format/type` - added the new optional request property `search_settings` - request property `exclude_domains` deprecated - request property `include_domains` deprecated - added `#/components/schemas/ResponseFormatText, #/components/schemas/ResponseFormatJsonSchema, #/components/schemas/ResponseFormatJsonObject` to the `response_format` request property `oneOf` list - added the optional property `choices/items/message/executed_tools/items/search_results` to the response with the `200` status - **2025-05-02** `e4cd6fe4e6ac` — 2 info - added the new optional request property `exclude_domains` - added the new optional request property `include_domains` - **2025-04-22** `37498d19ece8` — 2 breaking, 6 info - removed the enum value `gemma-7b-it` of the request property `model/anyOf[subschema #2]/` - removed the enum value `mixtral-8x7b-32768` of the request property `model/anyOf[subschema #2]/` - added the new optional request property `metadata` - added the new optional request property `store` - added the new `gemma2-9b-it` enum value to the request property `model/anyOf[subschema #2]/` - added the new `llama-3.1-8b-instant` enum value to the request property `model/anyOf[subschema #2]/` - added the new `llama-3.3-70b-versatile` enum value to the request property `model/anyOf[subschema #2]/` - added the new `llama-guard-3-8b` enum value to the request property `model/anyOf[subschema #2]/` - **2025-04-01** `8d531e091886` — 2 info - added the optional property `choices/items/message/executed_tools` to the response with the `200` status - added the optional property `usage_breakdown` to the response with the `200` status - **2025-02-03** `d1588e103a6a` — 1 info - added the optional property `choices/items/message/reasoning` to the response with the `200` status - **2025-01-29** `c5b2589925cd` — 1 info - added the new optional request property `reasoning_format` - **2025-01-11** `8bf31041292f` — 2 info - added the new optional request property `max_completion_tokens` - request property `max_tokens` deprecated - **2025-01-09** `33be0d612b9f` — 1 info - added the new `auto` enum value to the request property `service_tier` - **2025-01-08** `b33d3547dd14` — 1 info - added the new optional request property `service_tier` - **2024-08-27** `1f0d266ba97b` — 6 warning - removed the request property `messages/items/oneOf[subschema #1: System message]/tool_call_id` - removed the request property `messages/items/oneOf[subschema #2: User message]/tool_call_id` - removed the request property `messages/items/oneOf[subschema #3: Assistant message]/tool_call_id` - removed the request property `messages/items/oneOf[subschema #4: Tool message]/name` - removed the request property `messages/items/oneOf[subschema #5: Function message]/tool_call_id` - removed the request property `stream_options` - **2024-06-26** `f2c71038b5ac` — 1 info - added the new optional request property `stream_options` - **2024-06-26** `d9cb66d87629` — 7 info - added the new optional request property `messages/items/oneOf[subschema #1: System message]/tool_call_id` - added the new optional request property `messages/items/oneOf[subschema #2: User message]/tool_call_id` - added the new optional request property `messages/items/oneOf[subschema #3: Assistant message]/tool_call_id` - added the new optional request property `messages/items/oneOf[subschema #4: Tool message]/name` - added the new optional request property `messages/items/oneOf[subschema #5: Function message]/tool_call_id` - the request property `messages/items/oneOf[subschema #3: Assistant message]/function_call/arguments` became optional - the request property `messages/items/oneOf[subschema #3: Assistant message]/function_call/name` became optional - **2024-05-25** `a4c1214ecaa2` — 1 breaking, 3 info - the `n` request property's max was decreased to `1.00` - added the new optional request property `parallel_tool_calls` - added the new `required` enum value to the request property `function_call/oneOf[subschema #1]/` - added the new `required` enum value to the request property `tool_choice/oneOf[subschema #1]/` - **2024-05-22** `0f93f9ac6d4a` — 12 breaking, 14 warning, 32 info - request property `response_format/type` was restricted to a list of enum values - the request property `messages/items/oneOf[subschema #2: User message]/name` became not nullable - the `functions` request property's minItems was increased to `1` - the `messages` request property's minItems was increased to `1` - removed `#/components/schemas/ChatToolChoice` from the `tool_choice` request property `oneOf` list - removed `subschema #1, subschema #2` from the `stop` request property `oneOf` list - the `model` request property type changed from `string` to no type - the response property `choices/items/logprobs` became nullable for the status `200` - the response property `choices/items/logprobs/content` became nullable for the status `200` - the response property `choices/items/logprobs/content/items/bytes` became nullable for the status `200` - the response property `choices/items/logprobs/content/items/top_logprobs/items/bytes` became nullable for the status `200` - the response property `choices/items/message/content` became nullable for the status `200` - the `top_p` request property's max was set to `1.00` - the `top_p` request property's min was set to `0.00` - removed the request property `messages/items/oneOf[subschema #1: System message]/tool_call_id` - removed the request property `messages/items/oneOf[subschema #2: User message]/tool_call_id` - removed the request property `messages/items/oneOf[subschema #3: Assistant message]/tool_call_id` - removed the request property `messages/items/oneOf[subschema #4: Tool message]/name` - removed the request property `messages/items/oneOf[subschema #5: Function message]/tool_call_id` - added the new `assistant` enum value to the `choices/items/message/role` response property for the response status `200` - added the new `chat.completion` enum value to the `object` response property for the response status `200` - added the new `function` enum value to the `choices/items/message/tool_calls/items/type` response property for the response status `200` - added the new `function_call` enum value to the `choices/items/finish_reason` response property for the response status `200` - added the new `length` enum value to the `choices/items/finish_reason` response property for the response status `200` - added the new `stop` enum value to the `choices/items/finish_reason` response property for the response status `200` - added the new `tool_calls` enum value to the `choices/items/finish_reason` response property for the response status `200` - the endpoint scheme security `api_key` was removed from the API - api tag `Chat` added - api tag `openai chat` removed - added `subschema #1, subschema #2` to the `model` request property `anyOf` list - the `temperature` request property default value `1` was added - the `top_p` request property default value `1` was added - the `type` request property default value `text` was added - added the new `json_object` enum value to the request property `response_format/type` - added the new `text` enum value to the request property `response_format/type` - added `#/components/schemas/ChatCompletionNamedToolChoice` to the `tool_choice` request property `oneOf` list - added `subschema #1, subschema #2` to the `stop` request property `oneOf` list - added the optional property `choices/items/message/function_call` to the response with the `200` status - the response property `choices/items/logprobs/content` became required for the status `200` - the response property `choices/items/logprobs/content/items/bytes` became required for the status `200` - …18 more - **2024-05-21** `45aff5d28bf6` — 6 breaking, 17 warning, 26 info - request property `tools/items/type` was restricted to a list of enum values - the request property `tools/items/function` became required - the request property `tools/items/function/name` became required - the request property `tools/items/type` became required - the `messages/items/` request property type changed from `object` to no type - the `tool_choice` request property type changed from `object` to no type - the `frequency_penalty` request property's max was set to `2.00` - the `n` request property's max was set to `128.00` - the `presence_penalty` request property's max was set to `2.00` - the `temperature` request property's max was set to `2.00` - the `top_logprobs` request property's max was set to `20.00` - the `frequency_penalty` request property's min was set to `-2.00` - the `n` request property's min was set to `1.00` - the `presence_penalty` request property's min was set to `-2.00` - the `temperature` request property's min was set to `0.00` - the `top_logprobs` request property's min was set to `0.00` - removed the request property `messages/items/content` - removed the request property `messages/items/name` - removed the request property `messages/items/role` - removed the request property `messages/items/tool_call_id` - removed the request property `messages/items/tool_calls` - removed the request property `tool_choice/string` - removed the request property `tool_choice/toolChoice` - added the new optional request property `function_call` - added the new optional request property `functions` - the request property `frequency_penalty` became nullable - the request property `logit_bias` became nullable - the request property `logprobs` became nullable - the request property `max_tokens` became nullable - the request property `n` became nullable - the request property `presence_penalty` became nullable - the request property `response_format` became nullable - the request property `seed` became nullable - the request property `stream` became nullable - the request property `temperature` became nullable - the request property `tool_choice` became nullable - the request property `tools` became nullable - the request property `top_logprobs` became nullable - the request property `top_p` became nullable - the request property `user` became nullable - …9 more - **2024-05-16** `4643bbeed705` — 1 info - request property `messages/items/content` list-of-types was widened by adding types `array` to media type `application/json` --- [Operation](https://skmtc.dev/groq/apis/groqcloud-api/docs/openai/v1/chat/completions/post.md) · [API](https://skmtc.dev/groq/apis/groqcloud-api.md) · [Page](https://skmtc.dev/groq/apis/groqcloud-api/changes/openai/v1/chat/completions/post)