---
title: "Changes to Create an async analysis task"
method: POST
path: "/analyze/tasks"
---

# Changes to Create an async analysis task

`POST /analyze/tasks`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 28 revisions.

- **2026-10-06** `8b021f9a1426`: 1 breaking, 7 info
- **2026-10-01** `69c273061729`: 1 warning
- **2026-09-17** `b8591e05c0ba`: 1 warning, 1 info
- **2026-09-12** `6205c7327cde`: 1 info
- **2026-08-22** `fd9d80e384a8`: 8 breaking, 9 warning
- **2026-08-20** `9c12cd88093a`: 1 breaking, 1 info
- **2026-07-26** `c0926990c662`: 1 info

## Changes

- **2026-10-06** `8b021f9a1426`: 1 breaking, 7 info
  - the `max_tokens` request property type changed from `integer` to no type
  - added the new optional request property `image`
  - added the new optional request property `response_format/segment_definitions/items/fields/items/items/fields`
  - the request property `video` became optional
  - added the new `object` enum value to the request property `response_format/segment_definitions/items/fields/items/items/type`
  - added the new `pegasus1.6` enum value to the request property `model_name`
  - added the new `time_array` enum value to the request property `response_format/segment_definitions/items/fields/items/type`
  - added `#/components/schemas/CreateAsyncAnalyzeRequestMaxTokens1, subschema #1` to the `max_tokens` request property `oneOf` list
- **2026-10-01** `69c273061729`: 1 warning
  - added the new `canceled` enum value to the `status` response property for the response status `202`
- **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 `analyzeAsync_tasks_create`
- **2026-08-22** `fd9d80e384a8`: 8 breaking, 9 warning
  - the `prompt_v2/input_text` request property's minLength was increased from `0` to `1`
  - the `prompt_v2/media_sources/items/name` request property's minLength was increased from `0` to `1`
  - the `response_format/segment_definitions/items/description` request property's minLength was increased from `0` to `1`
  - the `response_format/segment_definitions/items/fields/items/description` request property's minLength was increased from `0` to `1`
  - the `response_format/segment_definitions/items/fields/items/name` request property's minLength was increased from `0` to `1`
  - the `response_format/segment_definitions/items/id` request property's minLength was increased from `0` to `1`
  - the `response_format/segment_definitions/items/media_sources/items/name` request property's minLength was increased from `0` to `1`
  - added the pattern `^[a-zA-Z0-9_-]{1,64}$` to the request property `custom_id`
  - the `prompt_v2/media_sources/items/name` request property's maxLength was set to `50`
  - the `response_format/segment_definitions/items/fields/items/enum/items/` request property's maxLength was set to `100`
  - the `response_format/segment_definitions/items/fields/items/name` request property's maxLength was set to `50`
  - the `response_format/segment_definitions/items/id` request property's maxLength was set to `100`
  - the `response_format/segment_definitions/items/media_sources/items/name` request property's maxLength was set to `50`
  - the `max_tokens` request property's max was set to `98304.00`
  - the `max_segment_duration` request property's min was set to `2.00`
  - the `max_tokens` request property's min was set to `512.00`
  - the `min_segment_duration` request property's min was set to `2.00`
- **2026-08-20** `9c12cd88093a`: 1 breaking, 1 info
  - removed the enum value `pegasus1.2` of the request property `model_name`
  - the `model_name` request property default value changed from `pegasus1.2` to `pegasus1.5`
- **2026-07-26** `c0926990c662`: 1 info
  - added discriminator to `video` request property

---

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