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

# Changes to Create Flow Segments

`POST /flows/{flowId}/segments`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 23 revisions.

- **2026-07-10** `7a9a5cdbb3d2` — 2 info
- **2025-10-21** `4c8d2bfcb854` — 2 breaking, 6 info
- **2025-07-02** `fff531b4534a` — 1 breaking, 1 info
- **2025-06-11** `e3d4dd57646b` — 1 breaking, 8 warning, 2 info
- **2025-04-24** `b01aaf8cffe2` — 5 breaking, 6 info

## Changes

- **2026-07-10** `7a9a5cdbb3d2` — 2 info
  - added the new optional request property `oneOf[subschema #1: Flow Segment Post]/init_object_id`
  - added the new optional request property `oneOf[subschema #2]/items/init_object_id`
- **2025-10-21** `4c8d2bfcb854` — 2 breaking, 6 info
  - the request property `oneOf[subschema #1: Flow Segment Post]/get_urls/items/label` became required
  - the request property `oneOf[subschema #2]/items/get_urls/items/label` became required
  - added the new optional request property `oneOf[subschema #1: Flow Segment Post]/object_timerange`
  - added the new optional request property `oneOf[subschema #2]/items/object_timerange`
  - request property `oneOf[subschema #1: Flow Segment Post]/sample_count` deprecated
  - request property `oneOf[subschema #1: Flow Segment Post]/sample_offset` deprecated
  - request property `oneOf[subschema #2]/items/sample_count` deprecated
  - request property `oneOf[subschema #2]/items/sample_offset` deprecated
- **2025-07-02** `fff531b4534a` — 1 breaking, 1 info
  - removed `#/components/schemas/flowsegment` from the request body `oneOf` list
  - added `#/components/schemas/flowsegmentpost` to the request body `oneOf` list
- **2025-06-11** `e3d4dd57646b` — 1 breaking, 8 warning, 2 info
  - the request's body type/format changed from `object`/`` to ``/``
  - removed the request property `get_urls`
  - removed the request property `key_frame_count`
  - removed the request property `last_duration`
  - removed the request property `object_id`
  - removed the request property `sample_count`
  - removed the request property `sample_offset`
  - removed the request property `timerange`
  - removed the request property `ts_offset`
  - added `#/components/schemas/flowsegment, subschema #2` to the request body `oneOf` list
  - added the success response with the status `200`
- **2025-04-24** `b01aaf8cffe2` — 5 breaking, 6 info
  - added the new required request property `object_id`
  - added the new required request property `timerange`
  - removed `#/components/schemas/flowsegmentpost, subschema #2` from the request body `oneOf` list
  - the request's body type/format changed from ``/`` to `object`/``
  - removed the success response with the status `200`
  - added the new optional request property `get_urls`
  - added the new optional request property `key_frame_count`
  - added the new optional request property `last_duration`
  - added the new optional request property `sample_count`
  - added the new optional request property `sample_offset`
  - added the new optional request property `ts_offset`

---

[Operation](https://skmtc.dev/aws-samples/apis/time-addressable-media-store/docs/flows/:flowId/segments/post.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/post)