---
title: "Changes to List describes for a file segment"
method: GET
path: "/files/{file_id}/segments/{segment_id}/describes"
---

# Changes to List describes for a file segment

`GET /files/{file_id}/segments/{segment_id}/describes`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 70 revisions.

- **2026-10-30** `23d3f240819f`: 1 info
- **2026-08-31** `85130a1f5247`: 1 info
- **2026-03-11** `1d5d6115c0d0`: 5 breaking, 5 info
- **2026-01-30** `2e7f65543b55`: 1 info

## Changes

- **2026-10-30** `23d3f240819f`: 1 info
  - added the optional property `code` to the response with the `404` status
- **2026-08-31** `85130a1f5247`: 1 info
  - added the optional property `data/items/describe_config/prompt` to the response with the `200` status
- **2026-03-11** `1d5d6115c0d0`: 5 breaking, 5 info
  - for the `query` request parameter `include_data`, default value `false` was removed
  - for the `query` request parameter `limit`, default value `50` 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
  - for the `query` request parameter `status`, default value `completed` was removed
  - the `enable_audio_description` response's property default value `false` was removed for the status `200`
  - the `enable_scene_text` response's property default value `true` was removed for the status `200`
  - the `enable_speech` response's property default value `true` was removed for the status `200`
  - the `enable_summary` response's property default value `true` was removed for the status `200`
  - the `enable_visual_scene_description` response's property default value `true` was removed for the status `200`
- **2026-01-30** `2e7f65543b55`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/cloudglue/apis/cloudglue-api/docs/files/:file_id/segments/:segment_id/describes/get.md) - [API](https://skmtc.dev/cloudglue/apis/cloudglue-api.md) - [Page](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/files/:file_id/segments/:segment_id/describes/get)