--- title: "Changes to Create Chat Completions" method: POST path: "/v1/chat/completions" --- # Changes to Create Chat Completions `POST /v1/chat/completions` > Every recorded change to this operation, newest first. ## Timeline Changed in 8 of 21 revisions. - **2026-09-29** `2f7a4a0aac8f`: 1 info - **2026-09-29** `da70d9cd1957`: 1 breaking - **2026-09-21** `5fdbd3614b8c`: 9 breaking, 7 info - **2026-07-11** `0fd1d281f985`: 2 breaking, 5 warning - **2026-03-24** `50ec08f1fdf6`: 2 breaking, 12 info - **2026-03-10** `ef3add9564c0`: 2 breaking, 4 warning, 2 info - **2026-03-04** `618db9823ac3`: 2 breaking, 6 info - **2026-03-04** `46bc88767a37`: 3 breaking, 5 warning, 13 info ## Changes - **2026-09-29** `2f7a4a0aac8f`: 1 info - endpoint added - **2026-09-29** `da70d9cd1957`: 1 breaking - api path removed without deprecation - **2026-09-21** `5fdbd3614b8c`: 9 breaking, 7 info - request property `stream` list-of-types was narrowed by removing types `null` from media type `application/json` - request property `tools/anyOf[subschema #1]/` list-of-types was narrowed by removing types `null` from media type `application/json` - the `messages/items/` request property type changed from no type to `object` - the response property `headers` became optional for the status `404` - the response property `headers` became optional for the status `422` - the response property `headers` became optional for the status `503` - the `detail` response's property type changed from no type to `string` for status `404` - the `detail` response's property type changed from no type to `string` for status `422` - the `detail` response's property type changed from no type to `string` for status `503` - api operation id `chat_completions_v1_chat_completions_post` removed and replaced with `create_chat_completions_v1_chat_completions_post` - added `#/components/schemas/ChatCompletionResponse, #/components/schemas/ChatCompletionChunkResponse` to the response body `anyOf` list for the response status `200` - removed `#/components/schemas/ChatCompletion, #/components/schemas/ChatCompletionChunk` from the response body `anyOf` list for the response status `200` - added the non-success response with the status `400` - added the non-success response with the status `401` - added the non-success response with the status `403` - added the non-success response with the status `429` - **2026-07-11** `0fd1d281f985`: 2 breaking, 5 warning - removed `#/components/schemas/SearchTool, subschema #1` from the `tools/anyOf[subschema #1]/anyOf[subschema #1]/items/` request property `anyOf` list - the `tools/anyOf[subschema #1]/anyOf[subschema #1]/items/` request property type changed from no type to `object` - deleted the `query` request parameter `required` - removed the request property `search` - removed the request property `search_args` - removed the optional property `anyOf[subschema #1: ChatCompletion]/search_results` from the response with the `200` status - removed the optional property `anyOf[subschema #2: ChatCompletionChunk]/search_results` from the response with the `200` status - **2026-03-24** `50ec08f1fdf6`: 2 breaking, 12 info - the `anyOf[subschema #1: ChatCompletion]/usage/carbon/kWh` response's property type changed from `number` to `object` for status `200` - the `anyOf[subschema #1: ChatCompletion]/usage/carbon/kgCO2eq` response's property type changed from `number` to `object` for status `200` - the `temperature` request property default value `0.7` was removed - the `top_p` request property default value `1` was removed - added the optional property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kWh/max` to the response with the `200` status - added the optional property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kWh/min` to the response with the `200` status - added the optional property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kgCO2eq/max` to the response with the `200` status - added the optional property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kgCO2eq/min` to the response with the `200` status - added the optional property `anyOf[subschema #1: ChatCompletion]/usage/impacts` to the response with the `200` status - the `kWh` response's property default value `0` was removed for the status `200` - the `kgCO2eq` response's property default value `0` was removed for the status `200` - response property `anyOf[subschema #1: ChatCompletion]/usage/carbon` deprecated - response property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kWh` deprecated - response property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kgCO2eq` deprecated - **2026-03-10** `ef3add9564c0`: 2 breaking, 4 warning, 2 info - the `anyOf[subschema #1: ChatCompletion]/usage/carbon/kWh` response's property type changed from `object` to `number` for status `200` - the `anyOf[subschema #1: ChatCompletion]/usage/carbon/kgCO2eq` response's property type changed from `object` to `number` for status `200` - removed the optional property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kWh/max` from the response with the `200` status - removed the optional property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kWh/min` from the response with the `200` status - removed the optional property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kgCO2eq/max` from the response with the `200` status - removed the optional property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kgCO2eq/min` from the response with the `200` status - the `kWh` response's property default value `0` was added for the status `200` - the `kgCO2eq` response's property default value `0` was added for the status `200` - **2026-03-04** `618db9823ac3`: 2 breaking, 6 info - the `anyOf[subschema #1: ChatCompletion]/usage/carbon/kWh` response's property type changed from `number` to `object` for status `200` - the `anyOf[subschema #1: ChatCompletion]/usage/carbon/kgCO2eq` response's property type changed from `number` to `object` for status `200` - added the optional property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kWh/max` to the response with the `200` status - added the optional property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kWh/min` to the response with the `200` status - added the optional property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kgCO2eq/max` to the response with the `200` status - added the optional property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kgCO2eq/min` to the response with the `200` status - the `kWh` response's property default value `0` was removed for the status `200` - the `kgCO2eq` response's property default value `0` was removed for the status `200` - **2026-03-04** `46bc88767a37`: 3 breaking, 5 warning, 13 info - the `tools/anyOf[subschema #1]/anyOf[subschema #1]/items/` request property type changed from `object` to no type - the `anyOf[subschema #1: ChatCompletion]/usage/carbon/kWh` response's property type changed from `object` to `number` for status `200` - the `anyOf[subschema #1: ChatCompletion]/usage/carbon/kgCO2eq` response's property type changed from `object` to `number` for status `200` - removed the optional property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kWh/max` from the response with the `200` status - removed the optional property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kWh/min` from the response with the `200` status - removed the optional property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kgCO2eq/max` from the response with the `200` status - removed the optional property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kgCO2eq/min` from the response with the `200` status - removed the optional property `anyOf[subschema #1: ChatCompletion]/usage/impacts` from the response with the `200` status - added the new optional `query` request parameter `required` - added the new optional request property `search` - added the new optional request property `search_args` - added `#/components/schemas/SearchTool, subschema #1` to the `tools/anyOf[subschema #1]/anyOf[subschema #1]/items/` request property `anyOf` list - the `temperature` request property default value `0.7` was added - the `top_p` request property default value `1` was added - added the optional property `anyOf[subschema #1: ChatCompletion]/search_results` to the response with the `200` status - added the optional property `anyOf[subschema #2: ChatCompletionChunk]/search_results` to the response with the `200` status - the `kWh` response's property default value `0` was added for the status `200` - the `kgCO2eq` response's property default value `0` was added for the status `200` - response property `anyOf[subschema #1: ChatCompletion]/usage/carbon` reactivated - response property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kWh` reactivated - response property `anyOf[subschema #1: ChatCompletion]/usage/carbon/kgCO2eq` reactivated --- [Operation](https://skmtc.dev/betagouv/apis/opengatellm/docs/v1/chat/completions/post.md) - [API](https://skmtc.dev/betagouv/apis/opengatellm.md) - [Page](https://skmtc.dev/betagouv/apis/opengatellm/changes/v1/chat/completions/post)