---
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 operation, newest first.

## Timeline

Changed in 2 of 13 revisions.

- **2026-10-10** `50f9f470351c`: 4 breaking, 5 warning, 1 info
- **2026-08-31** `f58a06ea93d9`: 1 breaking, 4 info

## Changes

- **2026-10-10** `50f9f470351c`: 4 breaking, 5 warning, 1 info
  - the `messages/items/content/oneOf[subschema #2]/items/` request property type changed from `object` to no type
  - added `subschema #1, subschema #2` to the `choices/items/message/content/oneOf[subschema #2]/items/` response property `oneOf` list for the response status `200`
  - the `choices/items/message/content/oneOf[subschema #2]/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `choices/items/message/content/oneOf[subschema #2]/items/type` from the response with the `200` status
  - removed the request property `messages/items/content/oneOf[subschema #2]/items/image_url`
  - removed the request property `messages/items/content/oneOf[subschema #2]/items/text`
  - removed the request property `messages/items/content/oneOf[subschema #2]/items/type`
  - removed the optional property `choices/items/message/content/oneOf[subschema #2]/items/image_url` from the response with the `200` status
  - removed the optional property `choices/items/message/content/oneOf[subschema #2]/items/text` from the response with the `200` status
  - added `subschema #1, subschema #2` to the `messages/items/content/oneOf[subschema #2]/items/` request property `oneOf` list
- **2026-08-31** `f58a06ea93d9`: 1 breaking, 4 info
  - request property `reasoning_effort` was restricted to a list of enum values
  - 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`

---

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