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

# Changes to Create a flow

`POST /flows`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 13 of 68 revisions.

- **2026-10-16** `4ad548c528a8`: 6 breaking, 1 warning, 18 info
- **2026-08-13** `02da4f9ce3fd`: 6 info
- **2026-07-24** `618bd1cc1aed`: 1 info
- **2026-07-07** `d5d1e5ee8188`: 3 info
- **2026-06-29** `8f06726ac240`: 6 breaking
- **2026-06-28** `fd8fb6b29e38`: 1 info
- **2026-06-27** `99b4ade46263`: 1 breaking
- **2026-06-19** `7f577998739b`: 1 info
- **2026-06-19** `ec76cd771e68`: 1 breaking
- **2026-06-15** `c6e2a60c14c3`: 1 info
- **2026-06-13** `5ac9d00ef2c9`: 1 breaking
- **2026-06-08** `e6b482fcec9b`: 5 info
- **2026-06-05** `c4e48a5bbf02`: 1 info

## Changes

- **2026-10-16** `4ad548c528a8`: 6 breaking, 1 warning, 18 info
  - the `data/templateResolutionVersion` response property's max was increased from `2.00` to `3.00` for the response status `201`
  - the `data/blockedAt` response's property format changed from no format to `date-time` for status `201`
  - the `data/createdAt` response's property format changed from no format to `date-time` for status `201`
  - the `data/lastFailureAt` response's property format changed from no format to `date-time` for status `201`
  - the `data/lastTriggeredAt` response's property format changed from no format to `date-time` for status `201`
  - the `data/updatedAt` response's property format changed from no format to `date-time` for status `201`
  - added the new `undefined` enum value to the `data/lastFailureCode` response property for the response status `201`
  - added the new optional `header` request parameter `idempotency-key`
  - added the new optional request property `actions/items/children/items/key`
  - added the new optional request property `actions/items/children/items/recordingEnabled`
  - added the new optional request property `actions/items/key`
  - added the new optional request property `actions/items/recordingEnabled`
  - added the new optional request property `delivery`
  - added the new optional request property `recordingEnabled`
  - added the new optional request property `recordingPolicy`
  - the `selfHealingEnabled` request property default value `false` was removed
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
  - added the non-success response with the status `409`
  - added the required property `data/agentId` to the response with the `201` status
  - added the required property `data/archivedAt` to the response with the `201` status
  - added the required property `data/delivery` to the response with the `201` status
  - added the required property `data/lifecycleStatus` to the response with the `201` status
  - added the required property `data/recordingEnabled` to the response with the `201` status
  - added the required property `data/recordingPolicy` to the response with the `201` status
- **2026-08-13** `02da4f9ce3fd`: 6 info
  - added the new optional request property `healthMonitoringEnabled`
  - added the new optional request property `selfHealingEnabled`
  - added the new optional request property `selfHealingMaxAttempts`
  - added the required property `data/healthMonitoringEnabled` to the response with the `201` status
  - added the required property `data/selfHealingEnabled` to the response with the `201` status
  - added the required property `data/selfHealingMaxAttempts` to the response with the `201` status
- **2026-07-24** `618bd1cc1aed`: 1 info
  - added the required property `data/templateResolutionVersion` to the response with the `201` status
- **2026-07-07** `d5d1e5ee8188`: 3 info
  - response property `data/userId` deprecated
  - added the required property `data/createdBy` to the response with the `201` status
  - added the required property `data/ownerId` to the response with the `201` status
- **2026-06-29** `8f06726ac240`: 6 breaking
  - the request property `actions/items/children/items/overrides` became not nullable
  - the request property `actions/items/children/items/overrides/params/additionalProperties/` became not nullable
  - the request property `actions/items/overrides` became not nullable
  - the request property `actions/items/overrides/params/additionalProperties/` became not nullable
  - the request property `cooldownSeconds` became not nullable
  - the request property `notifyWebhookId` became not nullable
- **2026-06-28** `fd8fb6b29e38`: 1 info
  - endpoint added
- **2026-06-27** `99b4ade46263`: 1 breaking
  - api path removed without deprecation
- **2026-06-19** `7f577998739b`: 1 info
  - endpoint added
- **2026-06-19** `ec76cd771e68`: 1 breaking
  - api path removed without deprecation
- **2026-06-15** `c6e2a60c14c3`: 1 info
  - endpoint added
- **2026-06-13** `5ac9d00ef2c9`: 1 breaking
  - api path removed without deprecation
- **2026-06-08** `e6b482fcec9b`: 5 info
  - added the required property `data/blockedAt` to the response with the `201` status
  - added the required property `data/consecutiveFailures` to the response with the `201` status
  - added the required property `data/lastFailureAt` to the response with the `201` status
  - added the required property `data/lastFailureCode` to the response with the `201` status
  - added the required property `data/status` to the response with the `201` status
- **2026-06-05** `c4e48a5bbf02`: 1 info
  - endpoint added

---

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