---
title: "Changes to Create sync embeddings"
method: POST
path: "/embed-v2"
---

# Changes to Create sync embeddings

`POST /embed-v2`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 28 revisions.

- **2026-10-01** `69c273061729`: 1 breaking, 1 warning, 7 info
- **2026-09-17** `b8591e05c0ba`: 1 warning, 1 info
- **2026-09-12** `6205c7327cde`: 1 info
- **2026-09-01** `8bb2e6eb62e8`: 2 breaking, 2 warning, 15 info
- **2026-08-22** `fd9d80e384a8`: 8 breaking, 4 warning, 1 info
- **2026-08-12** `b6d766c2c340`: 1 breaking, 2 info
- **2026-07-26** `c0926990c662`: 3 breaking, 2 info

## Changes

- **2026-10-01** `69c273061729`: 1 breaking, 1 warning, 7 info
  - added `subschema #3, subschema #4, subschema #5` to the `metadata` response property `oneOf` list for the response status `200`
  - added the new `chunk` enum value to the `data/items/embedding_scope/oneOf[subschema #1: EmbeddingDataEmbeddingScope]/` response property for the response status `200`
  - added the new optional request property `embedding_dimension`
  - added the new `document` enum value to the request property `multi_input/media_sources/items/media_type`
  - added the non-success response with the status `413`
  - added the optional property `data/items/chunk_index` to the response with the `200` status
  - added the optional property `data/items/quadrant` to the response with the `200` status
  - added the optional property `usage/truncation_reason` to the response with the `200` status
  - removed `subschema #3, subschema #4, subschema #5` from the `metadata` response property `oneOf` list for the response status `200`
- **2026-09-17** `b8591e05c0ba`: 1 warning, 1 info
  - deleted the `header` request parameter `x-api-key`
  - the endpoint scheme security `x-api-key` was added to the API
- **2026-09-12** `6205c7327cde`: 1 info
  - api operation id `create` removed and replaced with `embed_v2_create`
- **2026-09-01** `8bb2e6eb62e8`: 2 breaking, 2 warning, 15 info
  - removed `subschema #1, subschema #2` from the `video/segmentation` request property `oneOf` list
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` to the `metadata` response property `oneOf` list for the response status `200`
  - added the new `page` enum value to the `data/items/embedding_scope/oneOf[subschema #1: EmbeddingDataEmbeddingScope]/` response property for the response status `200`
  - added the new `text` enum value to the `data/items/embedding_option/oneOf[subschema #1: EmbeddingDataEmbeddingOption]/` response property for the response status `200`
  - added the new optional request property `auto_truncate`
  - added the new optional request property `embedding_uncertainty`
  - the request property `multi_input/media_sources` became optional
  - the `duration_sec` request property default value `6` was removed
  - the `start_sec` request property default value `0` was removed
  - the `start_sec` request property default value `0` was removed
  - added the new `audio` enum value to the request property `multi_input/media_sources/items/media_type`
  - added the new `marengo3.5` enum value to the request property `model_name`
  - added the new `video` enum value to the request property `multi_input/media_sources/items/media_type`
  - added `subschema #1, subschema #2` to the `video/segmentation` request property `oneOf` list
  - added the optional property `data/items/embedding_uncertainty` to the response with the `200` status
  - added the optional property `data/items/end_page_number` to the response with the `200` status
  - added the optional property `data/items/start_page_number` to the response with the `200` status
  - added the optional property `usage` to the response with the `200` status
  - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` from the `metadata` response property `oneOf` list for the response status `200`
- **2026-08-22** `fd9d80e384a8`: 8 breaking, 4 warning, 1 info
  - the `audio/media_source/base64_string` request property's minLength was increased from `0` to `1`
  - the `image/media_source/base64_string` request property's minLength was increased from `0` to `1`
  - the `multi_input/media_sources/items/base64_string` request property's minLength was increased from `0` to `1`
  - the `text/input_text` request property's minLength was increased from `0` to `1`
  - the `text_image/input_text` request property's minLength was increased from `0` to `1`
  - the `text_image/media_source/base64_string` request property's minLength was increased from `0` to `1`
  - the `video/media_source/base64_string` request property's minLength was increased from `0` to `1`
  - removed `subschema #1, subschema #2` from the `video/segmentation` request property `oneOf` list
  - the `audio/segmentation/fixed/duration_sec` request property's max was set to `10.00`
  - the `audio/segmentation/fixed/duration_sec` request property's min was set to `2.00`
  - the `audio/start_sec` request property's min was set to `0.00`
  - the `video/start_sec` request property's min was set to `0.00`
  - added `subschema #1, subschema #2` to the `video/segmentation` request property `oneOf` list
- **2026-08-12** `b6d766c2c340`: 1 breaking, 2 info
  - the `video/segmentation` request property type changed from `object` to no type
  - added discriminator to `video/segmentation` request property
  - added `subschema #1, subschema #2` to the `video/segmentation` request property `oneOf` list
- **2026-07-26** `c0926990c662`: 3 breaking, 2 info
  - removed `#/components/schemas/VideoSegmentation0, #/components/schemas/VideoSegmentation1` from the `video/segmentation` request property `oneOf` list
  - the `video/segmentation` request property type changed from no type to `object`
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` to the `metadata` response property `oneOf` list for the response status `200`
  - added discriminator to `metadata` response property for the response status `200`
  - removed `#/components/schemas/EmbeddingImageMetadata, #/components/schemas/EmbeddingTextImageMetadata, #/components/schemas/EmbeddingAudioMetadata, #/components/schemas/EmbeddingVideoMetadata, #/components/schemas/EmbeddingMultiInputMetadata` from the `metadata` response property `oneOf` list for the response status `200`

---

[Operation](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/docs/embed-v2/post.md) - [API](https://skmtc.dev/twelvelabs/apis/twelvelabs-api.md) - [Page](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/changes/embed-v2/post)