---
title: "Changes to Create an async embedding task"
method: POST
path: "/embed-v2/tasks"
---

# Changes to Create an async embedding task

`POST /embed-v2/tasks`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 28 revisions.

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

## Changes

- **2026-10-01** `69c273061729`: 1 warning, 5 info
  - added the new `chunk` enum value to the `data/items/embedding_scope/oneOf[subschema #1: EmbeddingDataEmbeddingScope]/` response property for the response status `202`
  - added the new optional request property `document/segmentation`
  - added the new optional request property `embedding_dimension`
  - added the optional property `data/items/chunk_index` to the response with the `202` status
  - added the optional property `data/items/quadrant` to the response with the `202` status
  - added the optional property `metadata` to the response with the `202` status
- **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_tasks_create`
- **2026-09-01** `8bb2e6eb62e8`: 2 breaking, 4 warning, 19 info
  - removed `subschema #1, subschema #2` from the `video/segmentation` request property `oneOf` list
  - the `audio/segmentation` request property type changed from `object` to no type
  - removed the request property `audio/segmentation/fixed`
  - removed the request property `audio/segmentation/strategy`
  - added the new `page` enum value to the `data/items/embedding_scope/oneOf[subschema #1: EmbeddingDataEmbeddingScope]/` response property for the response status `202`
  - added the new `text` enum value to the `data/items/embedding_option/oneOf[subschema #1: EmbeddingDataEmbeddingOption]/` response property for the response status `202`
  - added the new optional request property `audio/time_based_metadata`
  - added the new optional request property `document`
  - added the new optional request property `embedding_uncertainty`
  - added the new optional request property `image`
  - added the new optional request property `video/time_based_metadata`
  - the `start_sec` request property default value `0` was removed
  - the `start_sec` request property default value `0` was removed
  - removed discriminator from `video/segmentation` request property
  - added the new `document` enum value to the request property `input_type`
  - added the new `image` enum value to the request property `input_type`
  - added the new `local` enum value to the request property `audio/embedding_scope/items/`
  - added the new `local` enum value to the request property `video/embedding_scope/items/`
  - added the new `marengo3.5` enum value to the request property `model_name`
  - added `#/components/schemas/AudioSegmentation, #/components/schemas/AsyncTemporalSegmentation` to the `audio/segmentation` request property `oneOf` list
  - added `#/components/schemas/VideoSegmentation, #/components/schemas/AsyncTemporalSegmentation` to the `video/segmentation` request property `oneOf` list
  - added the non-success response with the status `429`
  - added the optional property `data/items/embedding_uncertainty` to the response with the `202` status
  - added the optional property `data/items/end_page_number` to the response with the `202` status
  - added the optional property `data/items/start_page_number` to the response with the `202` status
- **2026-08-22** `fd9d80e384a8`: 3 breaking, 4 warning, 1 info
  - the `audio/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`: 2 breaking
  - 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`

---

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