---
title: "Changes to List describe jobs for a segmentation"
method: GET
path: "/segmentations/{segmentation_id}/describes"
---

# Changes to List describe jobs for a segmentation

`GET /segmentations/{segmentation_id}/describes`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 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`: 1 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 `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 `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
  - 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`: 1 info
  - endpoint added

---

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