---
title: "Changes to Retrieve the current state of a media description job"
method: GET
path: "/describe/{job_id}"
---

# Changes to Retrieve the current state of a media description job

`GET /describe/{job_id}`

> 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-24** `43ab642cc65d`: 4 info
- **2026-03-16** `9dc639e1d66c`: 1 info
- **2026-03-11** `1d5d6115c0d0`: 2 breaking, 8 info
- **2026-03-09** `3700d31a3ff8`: 3 info
- **2026-01-30** `2e7f65543b55`: 1 info
- **2026-01-23** `ec90d9cbfe49`: 1 info
- **2025-11-03** `86dd61a3e0f3`: 1 breaking, 7 warning, 2 info
- **2025-10-23** `711ac767a126`: 3 info

## Changes

- **2026-10-30** `23d3f240819f`: 2 info
  - added the optional property `code` to the response with the `404` status
  - added the optional property `code` to the response with the `500` status
- **2026-08-31** `85130a1f5247`: 1 info
  - added the optional property `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 `file` to the response with the `200` status
- **2026-06-22** `dc094f0637ef`: 1 info
  - added the optional property `describe_config/participants` to the response with the `200` status
- **2026-03-24** `43ab642cc65d`: 4 info
  - added the new enum value `speech_markdown` to the `query` request parameter `response_format`
  - added the new enum value `speech_srt` to the `query` request parameter `response_format`
  - added the new enum value `speech_text` to the `query` request parameter `response_format`
  - added the new enum value `speech_vtt` to the `query` request parameter `response_format`
- **2026-03-16** `9dc639e1d66c`: 1 info
  - added the optional property `use_in_default_index` to the response with the `200` status
- **2026-03-11** `1d5d6115c0d0`: 2 breaking, 8 info
  - for the `query` request parameter `include_thumbnails`, default value `false` was removed
  - for the `query` request parameter `response_format`, default value `json` was removed
  - added the new optional `query` request parameter `include_chapters`
  - added the new optional `query` request parameter `include_shots`
  - added the new optional `query` request parameter `include_word_timestamps`
  - added the optional property `chapters` to the response with the `200` status
  - added the optional property `data/allOf[#/components/schemas/DescribeOutput]/speech/items/words` to the response with the `200` status
  - added the optional property `shots` to the response with the `200` status
  - added the optional property `total_chapters` to the response with the `200` status
  - added the optional property `total_shots` to the response with the `200` status
- **2026-03-09** `3700d31a3ff8`: 3 info
  - added the new optional `query` request parameter `include_thumbnails`
  - added the optional property `data/allOf[subschema #1]/segment_summary/items/thumbnail_url` to the response with the `200` status
  - added the optional property `thumbnail_url` to the response with the `200` status
- **2026-01-30** `2e7f65543b55`: 1 info
  - added the optional property `segmentation_id` to the response with the `200` status
- **2026-01-23** `ec90d9cbfe49`: 1 info
  - added the new optional `query` request parameter `modalities`
- **2025-11-03** `86dd61a3e0f3`: 1 breaking, 7 warning, 2 info
  - the `data` response's property type changed from `object` to no type for status `200`
  - removed the optional property `data/content` from the response with the `200` status
  - removed the optional property `data/scene_text` from the response with the `200` status
  - removed the optional property `data/segment_summary` from the response with the `200` status
  - removed the optional property `data/speech` from the response with the `200` status
  - removed the optional property `data/summary` from the response with the `200` status
  - removed the optional property `data/title` from the response with the `200` status
  - removed the optional property `data/visual_scene_description` from the response with the `200` status
  - added the optional property `describe_config/enable_audio_description` to the response with the `200` status
  - added `#/components/schemas/DescribeOutput, subschema #1` to the `data` response property `allOf` list for the response status `200`
- **2025-10-23** `711ac767a126`: 3 info
  - added the new optional `query` request parameter `end_time_seconds`
  - added the new optional `query` request parameter `start_time_seconds`
  - added the optional property `duration_seconds` to the response with the `200` status

---

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