---
title: "Changes to List all media description jobs"
method: GET
path: "/describe"
---

# Changes to List all media description jobs

`GET /describe`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 12 of 70 revisions.

- **2026-10-30** `23d3f240819f`: 2 info
- **2026-08-31** `85130a1f5247`: 1 info
- **2026-07-22** `c02e52ec2e28`: 2 info
- **2026-06-22** `dc094f0637ef`: 1 info
- **2026-03-16** `9dc639e1d66c`: 1 info
- **2026-03-11** `1d5d6115c0d0`: 4 breaking, 5 info
- **2026-03-09** `3700d31a3ff8`: 2 info
- **2026-01-30** `2e7f65543b55`: 2 info
- **2026-01-23** `ec90d9cbfe49`: 1 info
- **2025-12-08** `0d987fc7e008`: 1 info
- **2025-11-03** `86dd61a3e0f3`: 1 breaking, 7 warning, 2 info
- **2025-10-23** `711ac767a126`: 1 info

## Changes

- **2026-10-30** `23d3f240819f`: 2 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `500` status
- **2026-08-31** `85130a1f5247`: 1 info
  - added the optional property `data/items/describe_config/prompt` to the response with the `200` status
- **2026-07-22** `c02e52ec2e28`: 2 info
  - added the new optional `query` request parameter `include_metadata`
  - added the optional property `data/items/file` to the response with the `200` status
- **2026-06-22** `dc094f0637ef`: 1 info
  - added the optional property `data/items/describe_config/participants` to the response with the `200` status
- **2026-03-16** `9dc639e1d66c`: 1 info
  - added the optional property `data/items/use_in_default_index` to the response with the `200` status
- **2026-03-11** `1d5d6115c0d0`: 4 breaking, 5 info
  - for the `query` request parameter `include_data`, default value `true` was removed
  - for the `query` request parameter `limit`, default value `20` was removed
  - for the `query` request parameter `offset`, default value `0` was removed
  - for the `query` request parameter `response_format`, default value `json` was removed
  - added the optional property `data/items/chapters` to the response with the `200` status
  - added the optional property `data/items/data/allOf[#/components/schemas/DescribeOutput]/speech/items/words` to the response with the `200` status
  - added the optional property `data/items/shots` to the response with the `200` status
  - added the optional property `data/items/total_chapters` to the response with the `200` status
  - added the optional property `data/items/total_shots` to the response with the `200` status
- **2026-03-09** `3700d31a3ff8`: 2 info
  - added the optional property `data/items/data/allOf[subschema #1]/segment_summary/items/thumbnail_url` to the response with the `200` status
  - added the optional property `data/items/thumbnail_url` to the response with the `200` status
- **2026-01-30** `2e7f65543b55`: 2 info
  - added the optional property `data/items/segmentation_id` to the response with the `200` status
  - added the required property `offset` to the response with the `200` status
- **2026-01-23** `ec90d9cbfe49`: 1 info
  - added the new optional `query` request parameter `modalities`
- **2025-12-08** `0d987fc7e008`: 1 info
  - added the new optional `query` request parameter `include_data`
- **2025-11-03** `86dd61a3e0f3`: 1 breaking, 7 warning, 2 info
  - the `data/items/data` response's property type changed from `object` to no type for status `200`
  - removed the optional property `data/items/data/content` from the response with the `200` status
  - removed the optional property `data/items/data/scene_text` from the response with the `200` status
  - removed the optional property `data/items/data/segment_summary` from the response with the `200` status
  - removed the optional property `data/items/data/speech` from the response with the `200` status
  - removed the optional property `data/items/data/summary` from the response with the `200` status
  - removed the optional property `data/items/data/title` from the response with the `200` status
  - removed the optional property `data/items/data/visual_scene_description` from the response with the `200` status
  - added the optional property `data/items/describe_config/enable_audio_description` to the response with the `200` status
  - added `#/components/schemas/DescribeOutput, subschema #1` to the `data/items/data` response property `allOf` list for the response status `200`
- **2025-10-23** `711ac767a126`: 1 info
  - added the optional property `data/items/duration_seconds` to the response with the `200` status

---

[Operation](https://skmtc.dev/cloudglue/apis/cloudglue-api/docs/describe/get.md) - [API](https://skmtc.dev/cloudglue/apis/cloudglue-api.md) - [Page](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/describe/get)