---
title: "Changes to Retrieve analysis task status and results"
method: GET
path: "/analyze/tasks/{task_id}"
---

# Changes to Retrieve analysis task status and results

`GET /analyze/tasks/{task_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 28 revisions.

- **2026-10-06** `8b021f9a1426`: 2 breaking, 5 info
- **2026-10-01** `69c273061729`: 2 warning, 4 info
- **2026-09-17** `b8591e05c0ba`: 1 warning, 1 info
- **2026-09-12** `6205c7327cde`: 1 info
- **2026-08-20** `9c12cd88093a`: 2 warning, 1 info

## Changes

- **2026-10-06** `8b021f9a1426`: 2 breaking, 5 info
  - added `#/components/schemas/AnalyzeTaskResponseRequestParamsMaxTokens, subschema #2` to the `request_params/oneOf[subschema #1: AnalyzeTaskResponseRequestParams]/max_tokens` response property `oneOf` list for the response status `200`
  - the `request_params/oneOf[subschema #1: AnalyzeTaskResponseRequestParams]/max_tokens` response's property type changed from `integer, null` to no type for status `200`
  - added the optional property `request_params/oneOf[subschema #1: AnalyzeTaskResponseRequestParams]/image` to the response with the `200` status
  - added the optional property `request_params/oneOf[subschema #1: AnalyzeTaskResponseRequestParams]/response_format/oneOf[subschema #1: AnalyzeTaskResponseRequestParamsResponseFormat]/segment_definitions/items/fields/items/format` to the response with the `200` status
  - added the optional property `request_params/oneOf[subschema #1: AnalyzeTaskResponseRequestParams]/response_format/oneOf[subschema #1: AnalyzeTaskResponseRequestParamsResponseFormat]/segment_definitions/items/fields/items/items/fields` to the response with the `200` status
  - added the optional property `request_params/oneOf[subschema #1: AnalyzeTaskResponseRequestParams]/response_format/oneOf[subschema #1: AnalyzeTaskResponseRequestParamsResponseFormat]/segment_time_format` to the response with the `200` status
  - the response property `request_params/oneOf[subschema #1: AnalyzeTaskResponseRequestParams]/response_format/oneOf[subschema #1: AnalyzeTaskResponseRequestParamsResponseFormat]/segment_definitions/items/fields/items/items/type` became required for the status `200`
- **2026-10-01** `69c273061729`: 2 warning, 4 info
  - added the new `canceled` enum value to the `status` response property for the response status `200`
  - added the new `video_id` enum value to the `video_source/oneOf[subschema #1: AnalyzeTaskResponseVideoSource]/type` response property for the response status `200`
  - added the optional property `batch_id` to the response with the `200` status
  - added the optional property `error/code` to the response with the `200` status
  - added the optional property `video_source/oneOf[subschema #1: AnalyzeTaskResponseVideoSource]/index_id` to the response with the `200` status
  - added the optional property `video_source/oneOf[subschema #1: AnalyzeTaskResponseVideoSource]/video_id` to the response with the `200` 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 `retrieve` removed and replaced with `analyzeAsync_tasks_retrieve`
- **2026-08-20** `9c12cd88093a`: 2 warning, 1 info
  - removed the optional property `video_source/oneOf[subschema #1: AnalyzeTaskResponseVideoSource]/index_id` from the response with the `200` status
  - removed the optional property `video_source/oneOf[subschema #1: AnalyzeTaskResponseVideoSource]/video_id` from the response with the `200` status
  - removed the `video_id` enum value from the `video_source/oneOf[subschema #1: AnalyzeTaskResponseVideoSource]/type` response property for the response status `200`

---

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