---
title: "Changes to Create a new flow."
method: POST
path: "/api/flows"
---

# Changes to Create a new flow.

`POST /api/flows`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 53 revisions.

- **2026-09-08** `d3638f78d539`: 1 info
- **2026-08-24** `3c20e2fe2611`: 1 info
- **2026-04-22** `92e85e5fb1db`: 1 warning, 7 info
- **2026-04-07** `10a3115dc8ca`: 1 breaking, 1 warning, 7 info
- **2026-04-07** `1e67862a080e`: 11 warning, 2 info

## Changes

- **2026-09-08** `d3638f78d539`: 1 info
  - added the non-success response with the status `400`
- **2026-08-24** `3c20e2fe2611`: 1 info
  - added the non-success response with the status `409`
- **2026-04-22** `92e85e5fb1db`: 1 warning, 7 info
  - added the new `tai` enum value to the `flow/properties/clock_type` response property for the response status `201`
  - added the new optional request property `properties/direct_media_timing`
  - added the new optional request property `properties/ntp_info`
  - added the new optional request property `properties/ntp_port`
  - added the new `tai` enum value to the request property `properties/clock_type`
  - added the optional property `flow/properties/direct_media_timing` to the response with the `201` status
  - added the optional property `flow/properties/ntp_info` to the response with the `201` status
  - added the optional property `flow/properties/ntp_port` to the response with the `201` status
- **2026-04-07** `10a3115dc8ca`: 1 breaking, 1 warning, 7 info
  - added the new required request property `id`
  - removed the request property `description`
  - added the new optional request property `blocks`
  - added the new optional request property `elements`
  - added the new optional request property `gst_state`
  - added the new optional request property `links`
  - added the new optional request property `properties`
  - added the new optional request property `running`
  - added the optional property `flow/properties/ephemeral` to the response with the `201` status
- **2026-04-07** `1e67862a080e`: 11 warning, 2 info
  - removed the request property `blocks`
  - removed the request property `elements`
  - removed the request property `gst_state`
  - removed the request property `id`
  - removed the request property `links`
  - removed the request property `properties`
  - removed the request property `running`
  - removed the optional property `flow/properties/direct_media_timing` from the response with the `201` status
  - removed the optional property `flow/properties/ephemeral` from the response with the `201` status
  - removed the optional property `flow/properties/ntp_info` from the response with the `201` status
  - removed the optional property `flow/properties/ntp_port` from the response with the `201` status
  - added the new optional request property `description`
  - removed the `tai` enum value from the `flow/properties/clock_type` response property for the response status `201`

---

[Operation](https://skmtc.dev/eyevinn/apis/strom-api/docs/api/flows/post.md) - [API](https://skmtc.dev/eyevinn/apis/strom-api.md) - [Page](https://skmtc.dev/eyevinn/apis/strom-api/changes/api/flows/post)