--- 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 6 of 13 revisions. - **2025-05-12** `f0bf5a2dde0f`: 1 info - **2025-02-13** `972a6a82c154`: 2 breaking, 2 info - **2025-02-13** `80c7915def57`: 10 breaking, 5 warning, 12 info - **2025-01-25** `d714acb641bd`: 2 breaking, 10 info - **2024-12-12** `444230182e5e`: 1 info - **2024-12-06** `45e3254839bd`: 6 breaking, 4 warning, 3 info ## Changes - **2025-05-12** `f0bf5a2dde0f`: 1 info - added the required property `usage/oneOf[#/components/schemas/CompletionUsage]/prompt_tokens_details/oneOf[#/components/schemas/PromptTokensDetails]/audio_tokens` to the response with the `200` status - **2025-02-13** `972a6a82c154`: 2 breaking, 2 info - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `allOf[#/components/schemas/ChatCompletionRequest]/messages/items/` request property `oneOf` list - added `subschema #1: System, subschema #2: User, subschema #3: Assistant, subschema #4: Tool` to the `choices/items/message` response property `oneOf` list for the response status `200` - added `subschema #1: System, subschema #2: User, subschema #3: Assistant, subschema #4: Tool` to the `allOf[#/components/schemas/ChatCompletionRequest]/messages/items/` request property `oneOf` list - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `choices/items/message` response property `oneOf` list for the response status `200` - **2025-02-13** `80c7915def57`: 10 breaking, 5 warning, 12 info - added the new required request property `allOf[#/components/schemas/ChatCompletionRequest]/tools/items/function` - added the new required request property `allOf[#/components/schemas/ChatCompletionRequest]/tools/items/type` - the `allOf[#/components/schemas/ChatCompletionRequest]/logit_bias/propertyNames/` request property type changed from `string` to `integer`, and format from no format to `int32` - the `allOf[#/components/schemas/ChatCompletionRequest]/messages/items/` request property type changed from `object` to no type - the `allOf[#/components/schemas/ChatCompletionRequest]/tools/items/` request property type changed from no type to `object` - added `#/components/schemas/ChatCompletionLogProbs, subschema #1` to the `choices/items/logprobs` response property `oneOf` list for the response status `200` - added `subschema #1, subschema #2, subschema #3, subschema #4` to the `choices/items/message` response property `oneOf` list for the response status `200` - the `choices/items/message` response's property type changed from `object` to no type for status `200` - removed the required property `choices/items/message/content` from the response with the `200` status - removed the required property `choices/items/message/role` from the response with the `200` status - the `allOf[#/components/schemas/ChatCompletionRequest]/logit_bias/propertyNames/` request property's min was set to `0.00` - removed the request property `allOf[#/components/schemas/ChatCompletionRequest]/messages/items/content` - removed the request property `allOf[#/components/schemas/ChatCompletionRequest]/messages/items/name` - removed the request property `allOf[#/components/schemas/ChatCompletionRequest]/messages/items/role` - removed the optional property `choices/items/message/name` from the response with the `200` status - added the new optional request property `allOf[#/components/schemas/ChatCompletionRequest]/max_completion_tokens` - added the new optional request property `allOf[#/components/schemas/ChatCompletionRequest]/parallel_tool_calls` - added the new optional request property `allOf[#/components/schemas/ChatCompletionRequest]/service_tier` - added the new optional request property `allOf[#/components/schemas/ChatCompletionRequest]/stream_options` - added the new optional request property `allOf[#/components/schemas/ChatCompletionRequest]/top_logprobs` - request property `allOf[#/components/schemas/ChatCompletionRequest]/max_tokens` deprecated - added `#/components/schemas/ResponseFormat, subschema #1` to the `allOf[#/components/schemas/ChatCompletionRequest]/response_format` request property `oneOf` list - added `#/components/schemas/ToolChoice, subschema #1` to the `allOf[#/components/schemas/ChatCompletionRequest]/tool_choice` request property `oneOf` list - added `subschema #1, subschema #2, subschema #3, subschema #4` to the `allOf[#/components/schemas/ChatCompletionRequest]/messages/items/` request property `oneOf` list - added the optional property `service_tier` to the response with the `200` status - added the optional property `usage/oneOf[#/components/schemas/CompletionUsage]/prompt_tokens_details` to the response with the `200` status - added the required property `object` to the response with the `200` status - **2025-01-25** `d714acb641bd`: 2 breaking, 10 info - added `#/components/schemas/ChatCompletionRequest, subschema #2` to the request body `allOf` list - the response's body type changed from no type to `object` for status `200` - api operation id `chat_completions_handler` removed and replaced with `chat_completions_create` - the endpoint scheme security `bearerAuth` was added to the API - api tag `Chat` added - api tag `Chat Completions` removed - added the optional property `system_fingerprint` to the response with the `200` status - added the optional property `usage` to the response with the `200` status - added the required property `choices` to the response with the `200` status - added the required property `created` to the response with the `200` status - added the required property `id` to the response with the `200` status - added the required property `model` to the response with the `200` status - **2024-12-12** `444230182e5e`: 1 info - api tag `Chat Completions` added - **2024-12-06** `45e3254839bd`: 6 breaking, 4 warning, 3 info - the response's body type changed from `object` to no type for status `200` - removed the required property `choices` from the response with the `200` status - removed the required property `created` from the response with the `200` status - removed the required property `id` from the response with the `200` status - removed the required property `model` from the response with the `200` status - removed the required property `object` from the response with the `200` status - removed `#/components/schemas/ChatCompletionRequest, subschema #2` from the request body `allOf` list - removed the optional property `service_tier` from the response with the `200` status - removed the optional property `system_fingerprint` from the response with the `200` status - removed the optional property `usage` from the response with the `200` status - api operation id `chat_completions_create` removed and replaced with `chat_completions_handler` - the endpoint scheme security `bearerAuth` was removed from the API - api tag `Chat` removed --- [Operation](https://skmtc.dev/atomaai/apis/atoma-proxy/docs/v1/chat/completions/post.md) - [API](https://skmtc.dev/atomaai/apis/atoma-proxy.md) - [Page](https://skmtc.dev/atomaai/apis/atoma-proxy/changes/v1/chat/completions/post)