---
title: "Changes to Embeddings"
method: POST
path: "/v1/embeddings"
---

# Changes to Embeddings

`POST /v1/embeddings`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 15 revisions.

- **2026-10-10** `e1c9fccc2a1a`: 20 breaking, 13 info
- **2026-05-13** `bf57df6e9183`: 7 info
- **2026-04-14** `a92cc1f233eb`: 6 info

## Changes

- **2026-10-10** `e1c9fccc2a1a`: 20 breaking, 13 info
  - removed `#/components/schemas/ELSERV2Request` from the request body `oneOf` list
  - response property `code` list-of-types was widened by adding types `null` to media type `application/json` of response `400`
  - 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 `404`
  - response property `code` list-of-types was widened by adding types `null` to media type `application/json` of response `409`
  - response property `code` list-of-types was widened by adding types `null` to media type `application/json` of response `429`
  - response property `code` list-of-types was widened by adding types `null` to media type `application/json` of response `500`
  - response property `code` list-of-types was widened by adding types `null` to media type `application/json` of response `503`
  - response property `code` list-of-types was widened by adding types `null` to media type `application/json` of response `504`
  - 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 `400`
  - 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 `404`
  - response property `request_id` list-of-types was widened by adding types `null` to media type `application/json` of response `409`
  - response property `request_id` list-of-types was widened by adding types `null` to media type `application/json` of response `429`
  - response property `request_id` list-of-types was widened by adding types `null` to media type `application/json` of response `500`
  - response property `request_id` list-of-types was widened by adding types `null` to media type `application/json` of response `503`
  - response property `request_id` list-of-types was widened by adding types `null` to media type `application/json` of response `504`
  - removed `elser-v2` mapping keys from the request discriminator
  - added the optional property `code` to the response with the `422` status
  - added the optional property `errors` to the response with the `400` 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 `404` status
  - added the optional property `errors` to the response with the `409` status
  - added the optional property `errors` to the response with the `429` status
  - added the optional property `errors` to the response with the `500` status
  - added the optional property `errors` to the response with the `503` status
  - added the optional property `errors` to the response with the `504` status
  - added the optional property `request_id` to the response with the `422` status
  - the response property `detail` became required for the status `422`
- **2026-05-13** `bf57df6e9183`: 7 info
  - added `jina-embeddings-v5-omni-small, jina-embeddings-v5-omni-nano` mapping keys to the request discriminator
  - added `#/components/schemas/ImageDoc, #/components/schemas/VideoDoc, #/components/schemas/AudioDoc, #/components/schemas/MergedContentGroup` to the `oneOf[subschema #3: EmbeddingsV5Request]/input/anyOf[subschema #3 -> subschema #7]/items/` request property `anyOf` list
  - added `#/components/schemas/ImageDoc, #/components/schemas/VideoDoc, #/components/schemas/AudioDoc, #/components/schemas/PDFDoc` to the `oneOf[subschema #3: EmbeddingsV5Request]/input` request property `anyOf` list
  - added the new `jina-embeddings-v5-omni-nano` enum value to the request property `oneOf[subschema #3: EmbeddingsV5Request]/model`
  - added the new `jina-embeddings-v5-omni-small` enum value to the request property `oneOf[subschema #3: EmbeddingsV5Request]/model`
  - added the optional property `usage/anyOf[subschema #1: EmbeddingUsage]/audio_tokens` to the response with the `200` status
  - added the optional property `usage/anyOf[subschema #1: EmbeddingUsage]/video_tokens` to the response with the `200` status
- **2026-04-14** `a92cc1f233eb`: 6 info
  - added `jina-embeddings-v5-text-nano, jina-embeddings-v5-text-small, elser-v2` mapping keys to the request discriminator
  - added `#/components/schemas/EmbeddingsV5Request, #/components/schemas/ELSERV2Request` to the request body `oneOf` list
  - added the optional property `usage/anyOf[subschema #1: EmbeddingUsage]/image_tokens` to the response with the `200` status
  - added `#/components/schemas/ELSERV2EmbeddingUsage` to the `usage` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #3` to the `data` response property `anyOf` list for the response status `200`
  - removed `subschema #1` from the `data` response property `anyOf` list for the response status `200`

---

[Operation](https://skmtc.dev/jina/apis/jina-search-foundation-api/docs/v1/embeddings/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/embeddings/post)
