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

# Changes to Create a chat completion.

`POST /v1/chat/completions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 6 revisions.

- **2026-05-05** `df4ebeefaa60` — 1 info
- **2026-04-27** `6768d19ec03d` — 1 info
- **2026-04-27** `5005084f1ab9` — 1 breaking, 1 info
- **2026-04-27** `0deddbed852c` — 1 breaking, 1 warning, 2 info

## Changes

- **2026-05-05** `df4ebeefaa60` — 1 info
  - added the new optional request property `stream_options`
- **2026-04-27** `6768d19ec03d` — 1 info
  - added the non-success response with the status `409`
- **2026-04-27** `5005084f1ab9` — 1 breaking, 1 info
  - response property `choices/items/message/content` list-of-types was widened by adding types `array` to media type `application/json` of response `200`
  - request property `messages/items/content` list-of-types was widened by adding types `array` to media type `application/json`
- **2026-04-27** `0deddbed852c` — 1 breaking, 1 warning, 2 info
  - request property `messages/items/content` list-of-types was narrowed by removing types `array` from media type `application/json`
  - removed the request property `stream_options`
  - removed the non-success response with the status `409`
  - response property `choices/items/message/content` list-of-types was narrowed by removing types `array` from media type `application/json` of response `200`

---

[Operation](https://skmtc.dev/docker/apis/docker-agent-chat-completions/docs/v1/chat/completions/post.md) · [API](https://skmtc.dev/docker/apis/docker-agent-chat-completions.md) · [Page](https://skmtc.dev/docker/apis/docker-agent-chat-completions/changes/v1/chat/completions/post)