---
title: "Changes to Retrieve media description data for a specific file in a collection"
method: GET
path: "/collections/{collection_id}/videos/{file_id}/media-descriptions"
---

# Changes to Retrieve media description data for a specific file in a collection

`GET /collections/{collection_id}/videos/{file_id}/media-descriptions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 70 revisions.

- **2026-10-30** `23d3f240819f`: 3 info
- **2026-07-22** `c02e52ec2e28`: 2 info
- **2026-03-11** `1d5d6115c0d0`: 2 breaking, 8 info
- **2026-03-09** `3700d31a3ff8`: 3 info
- **2026-01-23** `ec90d9cbfe49`: 1 info
- **2025-11-03** `86dd61a3e0f3`: 3 breaking, 8 warning, 1 info
- **2025-10-23** `711ac767a126`: 3 info

## Changes

- **2026-10-30** `23d3f240819f`: 3 info
  - added the optional property `code` to the response with the `400` status
  - 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-07-22** `c02e52ec2e28`: 2 info
  - added the new optional `query` request parameter `include_metadata`
  - added the optional property `allOf[subschema #1]/file` 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 `allOf[#/components/schemas/DescribeOutput]/speech/items/words` to the response with the `200` status
  - added the optional property `allOf[subschema #1]/chapters` to the response with the `200` status
  - added the optional property `allOf[subschema #1]/shots` to the response with the `200` status
  - added the optional property `allOf[subschema #1]/total_chapters` to the response with the `200` status
  - added the optional property `allOf[subschema #1]/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 `allOf[subschema #1]/segment_summary/items/thumbnail_url` to the response with the `200` status
  - added the optional property `allOf[subschema #1]/thumbnail_url` 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`: 3 breaking, 8 warning, 1 info
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `collection_id` from the response with the `200` status
  - removed the required property `file_id` from the response with the `200` status
  - removed the optional property `content` from the response with the `200` status
  - removed the optional property `duration_seconds` from the response with the `200` status
  - removed the optional property `scene_text` from the response with the `200` status
  - removed the optional property `segment_summary` from the response with the `200` status
  - removed the optional property `speech` from the response with the `200` status
  - removed the optional property `summary` from the response with the `200` status
  - removed the optional property `title` from the response with the `200` status
  - removed the optional property `visual_scene_description` from the response with the `200` status
  - added `#/components/schemas/DescribeOutput, subschema #1` to the response body `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/collections/:collection_id/videos/:file_id/media-descriptions/get.md) - [API](https://skmtc.dev/cloudglue/apis/cloudglue-api.md) - [Page](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/collections/:collection_id/videos/:file_id/media-descriptions/get)