---
title: "Changes to Chat Completions"
method: POST
path: "/v1/chat/completions"
---

# Changes to Chat Completions

`POST /v1/chat/completions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 15 revisions.

- **2026-10-10** `e1c9fccc2a1a`: 13 breaking, 12 warning, 12 info
- **2026-09-10** `d16aa597a85d`: 2 breaking, 3 info
- **2026-04-14** `a92cc1f233eb`: 2 info
- **2026-02-04** `9bb79ddff926`: 1 info

## Changes

- **2026-10-10** `e1c9fccc2a1a`: 13 breaking, 12 warning, 12 info
  - response property `code` list-of-types was widened by adding types `null` to media type `application/json` of response `401`
  - response property `code` list-of-types was widened by adding types `null` to media type `application/json` of response `403`
  - response property `code` list-of-types was widened by adding types `null` to media type `application/json` of response `429`
  - response property `errors` list-of-types was widened by adding types `null` to media type `application/json` of response `422`
  - response property `request_id` list-of-types was widened by adding types `null` to media type `application/json` of response `401`
  - response property `request_id` list-of-types was widened by adding types `null` to media type `application/json` of response `403`
  - response property `request_id` list-of-types was widened by adding types `null` to media type `application/json` of response `429`
  - removed the required property `detail` from the response with the `400` status
  - removed the required property `detail` from the response with the `404` status
  - removed the required property `detail` from the response with the `409` status
  - removed the required property `detail` from the response with the `500` status
  - removed the required property `detail` from the response with the `503` status
  - removed the required property `detail` from the response with the `504` status
  - removed the optional property `code` from the response with the `400` status
  - removed the optional property `code` from the response with the `404` status
  - removed the optional property `code` from the response with the `409` status
  - removed the optional property `code` from the response with the `500` status
  - removed the optional property `code` from the response with the `503` status
  - removed the optional property `code` from the response with the `504` status
  - removed the optional property `request_id` from the response with the `400` status
  - removed the optional property `request_id` from the response with the `404` status
  - removed the optional property `request_id` from the response with the `409` status
  - removed the optional property `request_id` from the response with the `500` status
  - removed the optional property `request_id` from the response with the `503` status
  - removed the optional property `request_id` from the response with the `504` status
  - added the optional property `code` to the response with the `422` status
  - added the optional property `errors` to the response with the `401` status
  - added the optional property `errors` to the response with the `403` status
  - added the optional property `errors` to the response with the `429` status
  - added the optional property `request_id` to the response with the `422` status
  - the response property `detail` became required for the status `422`
  - added the required property `error` to the response with the `400` status
  - added the required property `error` to the response with the `404` status
  - added the required property `error` to the response with the `409` status
  - added the required property `error` to the response with the `500` status
  - added the required property `error` to the response with the `503` status
  - added the required property `error` to the response with the `504` status
- **2026-09-10** `d16aa597a85d`: 2 breaking, 3 info
  - added required request body
  - the response's body type changed from `object` to no type for status `200`
  - api tag `Generative Models` added
  - api tag `Search Foundation Models` removed
  - added the non-success response with the status `422`
- **2026-04-14** `a92cc1f233eb`: 2 info
  - api tag `Search Foundation Models` added
  - api tag `Vision Language Models` removed
- **2026-02-04** `9bb79ddff926`: 1 info
  - endpoint added

---

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