---
title: "Changes to List Flow Segments"
method: GET
path: "/flows/{flowId}/segments"
---

# Changes to List Flow Segments

`GET /flows/{flowId}/segments`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 24 revisions.

- **2026-08-25** `eb3977b33601`: 4 info
- **2026-07-10** `7a9a5cdbb3d2`: 3 info
- **2025-10-21** `4c8d2bfcb854`: 4 info
- **2025-10-06** `0eeba8c316ce`: 2 breaking, 6 warning, 1 info
- **2025-07-02** `fff531b4534a`: 1 breaking, 1 warning, 4 info
- **2025-06-11** `e3d4dd57646b`: 1 warning, 3 info
- **2025-04-24** `b01aaf8cffe2`: 5 warning, 9 info

## Changes

- **2026-08-25** `eb3977b33601`: 4 info
  - added the new optional `query` request parameter `storage_backend_tag.{name}`
  - added the new optional `query` request parameter `storage_backend_tag_exists.{name}`
  - added the optional property `items/allOf[subschema #1]/init_object/allOf[subschema #2: Object]/get_urls/items/allOf[subschema #1: Storage Backend]/tags` to the response with the `200` status
  - added the optional property `items/allOf[subschema #2: Object]/allOf[subschema #2: Object]/get_urls/items/allOf[subschema #1: Storage Backend]/tags` to the response with the `200` status
- **2026-07-10** `7a9a5cdbb3d2`: 3 info
  - added the optional property `items/allOf[subschema #1]/init_object` to the response with the `200` status
  - added `#/components/schemas/objectmediacore` to the `items/` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/objectcore` from the `items/` response property `allOf` list for the response status `200`
- **2025-10-21** `4c8d2bfcb854`: 4 info
  - added the new optional `query` request parameter `include_object_timerange`
  - added the optional property `items/allOf[subschema #1]/object_timerange` to the response with the `200` status
  - response property `items/allOf[subschema #1]/sample_count` deprecated
  - response property `items/allOf[subschema #1]/sample_offset` deprecated
- **2025-10-06** `0eeba8c316ce`: 2 breaking, 6 warning, 1 info
  - removed the required property `items/object_id` from the response with the `200` status
  - removed the required property `items/timerange` from the response with the `200` status
  - removed the optional property `items/get_urls` from the response with the `200` status
  - removed the optional property `items/key_frame_count` from the response with the `200` status
  - removed the optional property `items/last_duration` from the response with the `200` status
  - removed the optional property `items/sample_count` from the response with the `200` status
  - removed the optional property `items/sample_offset` from the response with the `200` status
  - removed the optional property `items/ts_offset` from the response with the `200` status
  - added `#/components/schemas/objectcore, subschema #1` to the `items/` response property `allOf` list for the response status `200`
- **2025-07-02** `fff531b4534a`: 1 breaking, 1 warning, 4 info
  - removed the required property `items/get_urls/items/url` from the response with the `200` status
  - removed the optional property `items/get_urls/items/label` from the response with the `200` status
  - added the new optional `query` request parameter `accept_storage_ids`
  - added the new optional `query` request parameter `presigned`
  - added the new optional `query` request parameter `verbose_storage`
  - added `#/components/schemas/storagebackend, subschema #2` to the `items/get_urls/items/` response property `allOf` list for the response status `200`
- **2025-06-11** `e3d4dd57646b`: 1 warning, 3 info
  - changed the pattern of the `query` request parameter `timerange` from `^(\[|\()?(-?\d+:\d+)?(_(-?\d+:\d+)?)?(\]|\))?$` to `^(\[|\()?(-?(0|[1-9][0-9]*):(0|[1-9][0-9]{0,8}))?(_(-?(0|[1-9][0-9]*):(0|[1-9][0-9]{0,8}))?)?(\]|\))?$`
  - the `items/last_duration` response's property pattern was changed from `^-?\d+:\d+$` to `^-?(0|[1-9][0-9]*):(0|[1-9][0-9]{0,8})$` for the status `200`
  - the `items/timerange` response's property pattern was changed from `^(\[|\()?(-?\d+:\d+)?(_(-?\d+:\d+)?)?(\]|\))?$` to `^(\[|\()?(-?(0|[1-9][0-9]*):(0|[1-9][0-9]{0,8}))?(_(-?(0|[1-9][0-9]*):(0|[1-9][0-9]{0,8}))?)?(\]|\))?$` for the status `200`
  - the `items/ts_offset` response's property pattern was changed from `^-?\d+:\d+$` to `^-?(0|[1-9][0-9]*):(0|[1-9][0-9]{0,8})$` for the status `200`
- **2025-04-24** `b01aaf8cffe2`: 5 warning, 9 info
  - changed the pattern of the `query` request parameter `timerange` from `^(\[|\()?(-?(0|[1-9][0-9]*):(0|[1-9][0-9]{0,8}))?(_(-?(0|[1-9][0-9]*):(0|[1-9][0-9]{0,8}))?)?(\]|\))?$` to `^(\[|\()?(-?\d+:\d+)?(_(-?\d+:\d+)?)?(\]|\))?$`
  - deleted the `query` request parameter `accept_storage_ids`
  - deleted the `query` request parameter `include_object_timerange`
  - deleted the `query` request parameter `presigned`
  - deleted the `query` request parameter `verbose_storage`
  - added the optional property `items/get_urls` to the response with the `200` status
  - added the optional property `items/key_frame_count` to the response with the `200` status
  - added the optional property `items/last_duration` to the response with the `200` status
  - added the optional property `items/sample_count` to the response with the `200` status
  - added the optional property `items/sample_offset` to the response with the `200` status
  - added the optional property `items/ts_offset` to the response with the `200` status
  - removed `#/components/schemas/objectmediacore, subschema #1` from the `items/` response property `allOf` list for the response status `200`
  - added the required property `items/object_id` to the response with the `200` status
  - added the required property `items/timerange` to the response with the `200` status

---

[Operation](https://skmtc.dev/aws-samples/apis/time-addressable-media-store/docs/flows/:flowId/segments/get.md) - [API](https://skmtc.dev/aws-samples/apis/time-addressable-media-store.md) - [Page](https://skmtc.dev/aws-samples/apis/time-addressable-media-store/changes/flows/:flowId/segments/get)