---
title: "Changes to Create or Update Flow Collection"
method: PUT
path: "/flows/{flowId}/flow_collection"
---

# Changes to Create or Update Flow Collection

`PUT /flows/{flowId}/flow_collection`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 24 revisions.

- **2026-08-25** `eb3977b33601`: 1 info
- **2025-07-02** `fff531b4534a`: 1 breaking, 3 warning
- **2025-04-24** `b01aaf8cffe2`: 2 breaking, 1 warning, 1 info

## Changes

- **2026-08-25** `eb3977b33601`: 1 info
  - the request property `items/allOf[subschema #1: Collection Item]/role` became optional
- **2025-07-02** `fff531b4534a`: 1 breaking, 3 warning
  - added `#/components/schemas/collectionitem, subschema #2` to the `items/` request property `allOf` list
  - removed the request property `items/container_mapping`
  - removed the request property `items/id`
  - removed the request property `items/role`
- **2025-04-24** `b01aaf8cffe2`: 2 breaking, 1 warning, 1 info
  - added the new required request property `items/id`
  - added the new required request property `items/role`
  - removed `#/components/schemas/collectionitem, subschema #2` from the `items/` request property `allOf` list
  - added the new optional request property `items/container_mapping`

---

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