---
title: "Changes to Create a workflow"
method: POST
path: "/v2/workflows"
---

# Changes to Create a workflow

`POST /v2/workflows`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 20 revisions.

- **2026-10-21** `a5b639d63138`: 6 breaking, 23 info
- **2026-10-14** `951a80501fce`: 13 info
- **2026-09-28** `f056922796ad`: 12 breaking, 8 info
- **2026-08-28** `16a345244098`: 2 breaking
- **2026-08-16** `c2b2fa0d5d48`: 11 warning, 3 info
- **2026-08-10** `b8c9ccc86d6e`: 22 warning, 22 info
- **2026-08-04** `ca78ba235703`: 14 info
- **2026-07-31** `8092e41edd57`: 11 breaking, 14 info
- **2026-07-26** `ab1c5d528f97`: 13 warning, 11 info
- **2026-07-21** `c69777f60184`: 1 breaking, 30 warning, 11 info

## Changes

- **2026-10-21** `a5b639d63138`: 6 breaking, 23 info
  - the `agent` request property type changed from no type to `object`
  - the `preferences/allOf[#/components/schemas/PreferencesRequestDto]/workflow` request property type changed from no type to `object`
  - the `agent` response's property type changed from no type to `object` for status `201`
  - the `lastPublishedBy` response's property type changed from no type to `object` for status `201`
  - the `preferences/allOf[#/components/schemas/WorkflowPreferencesResponseDto]/user` response's property type changed from no type to `object` for status `201`
  - the `updatedBy` response's property type changed from no type to `object` for status `201`
  - the `type` request property default value `chat` was added
  - the `type` request property default value `custom` was added
  - the `type` request property default value `delay` was added
  - the `type` request property default value `digest` was added
  - the `type` request property default value `email` was added
  - the `type` request property default value `http_request` was added
  - the `type` request property default value `in_app` was added
  - the `type` request property default value `push` was added
  - the `type` request property default value `sms` was added
  - the `type` request property default value `throttle` was added
  - the `type` request property default value `tool` was added
  - removed the pattern `SLUG_IDENTIFIER_REGEX` from the request property `steps/items/oneOf[#/components/schemas/ChatStepUpsertDto]/stepId`
  - removed the pattern `SLUG_IDENTIFIER_REGEX` from the request property `steps/items/oneOf[#/components/schemas/CustomStepUpsertDto]/stepId`
  - removed the pattern `SLUG_IDENTIFIER_REGEX` from the request property `steps/items/oneOf[#/components/schemas/DelayStepUpsertDto]/stepId`
  - removed the pattern `SLUG_IDENTIFIER_REGEX` from the request property `steps/items/oneOf[#/components/schemas/DigestStepUpsertDto]/stepId`
  - removed the pattern `SLUG_IDENTIFIER_REGEX` from the request property `steps/items/oneOf[#/components/schemas/EmailStepUpsertDto]/stepId`
  - removed the pattern `SLUG_IDENTIFIER_REGEX` from the request property `steps/items/oneOf[#/components/schemas/HttpRequestStepUpsertDto]/stepId`
  - removed the pattern `SLUG_IDENTIFIER_REGEX` from the request property `steps/items/oneOf[#/components/schemas/InAppStepUpsertDto]/stepId`
  - removed the pattern `SLUG_IDENTIFIER_REGEX` from the request property `steps/items/oneOf[#/components/schemas/PushStepUpsertDto]/stepId`
  - removed the pattern `SLUG_IDENTIFIER_REGEX` from the request property `steps/items/oneOf[#/components/schemas/SmsStepUpsertDto]/stepId`
  - removed the pattern `SLUG_IDENTIFIER_REGEX` from the request property `steps/items/oneOf[#/components/schemas/ThrottleStepUpsertDto]/stepId`
  - removed the pattern `SLUG_IDENTIFIER_REGEX` from the request property `steps/items/oneOf[#/components/schemas/ToolStepUpsertDto]/stepId`
  - removed the pattern `SLUG_IDENTIFIER_REGEX` from the request property `workflowId`
- **2026-10-14** `951a80501fce`: 13 info
  - added the new optional request property `steps/items/oneOf[#/components/schemas/ChatStepUpsertDto]/integrationOverrides`
  - added the new optional request property `steps/items/oneOf[#/components/schemas/ToolStepUpsertDto]/integrationOverrides`
  - added the optional property `steps/items/oneOf[#/components/schemas/ChatStepResponseDto]/integrationOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/CustomStepResponseDto]/integrationOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/DelayStepResponseDto]/integrationOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/DigestStepResponseDto]/integrationOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/integrationOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/HttpRequestStepResponseDto]/integrationOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/InAppStepResponseDto]/integrationOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/PushStepResponseDto]/integrationOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/SmsStepResponseDto]/integrationOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/ThrottleStepResponseDto]/integrationOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/ToolStepResponseDto]/integrationOverrides` to the response with the `201` status
- **2026-09-28** `f056922796ad`: 12 breaking, 8 info
  - the response property `steps/items/oneOf[#/components/schemas/ChatStepResponseDto]/controls/allOf[#/components/schemas/ChatControlsMetadataResponseDto]/values` became optional for the status `201`
  - the response property `steps/items/oneOf[#/components/schemas/CustomStepResponseDto]/controls/allOf[#/components/schemas/CustomControlsMetadataResponseDto]/values` became optional for the status `201`
  - the response property `steps/items/oneOf[#/components/schemas/DelayStepResponseDto]/controls/allOf[#/components/schemas/DelayControlsMetadataResponseDto]/values` became optional for the status `201`
  - the response property `steps/items/oneOf[#/components/schemas/DigestStepResponseDto]/controls/allOf[#/components/schemas/DigestControlsMetadataResponseDto]/values` became optional for the status `201`
  - the response property `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/controls/allOf[#/components/schemas/EmailControlsMetadataResponseDto]/values` became optional for the status `201`
  - the response property `steps/items/oneOf[#/components/schemas/HttpRequestStepResponseDto]/controls/allOf[#/components/schemas/HttpRequestControlsMetadataResponseDto]/values` became optional for the status `201`
  - the response property `steps/items/oneOf[#/components/schemas/InAppStepResponseDto]/controls/allOf[#/components/schemas/InAppControlsMetadataResponseDto]/values` became optional for the status `201`
  - the response property `steps/items/oneOf[#/components/schemas/PushStepResponseDto]/controls/allOf[#/components/schemas/PushControlsMetadataResponseDto]/values` became optional for the status `201`
  - the response property `steps/items/oneOf[#/components/schemas/SmsStepResponseDto]/controls/allOf[#/components/schemas/SmsControlsMetadataResponseDto]/values` became optional for the status `201`
  - the response property `steps/items/oneOf[#/components/schemas/ThrottleStepResponseDto]/controls/allOf[#/components/schemas/ThrottleControlsMetadataResponseDto]/values` became optional for the status `201`
  - the response property `steps/items/oneOf[#/components/schemas/ToolStepResponseDto]/controls/allOf[#/components/schemas/ToolControlsMetadataResponseDto]/values` became optional for the status `201`
  - the `issues/additionalProperties/` response's property type changed from `object` to `array` for status `201`
  - added the new optional request property `preferences/allOf[#/components/schemas/PreferencesRequestDto]/user/oneOf[#/components/schemas/WorkflowPreferencesDto]/all/allOf[#/components/schemas/WorkflowPreferenceDto]/condition`
  - added the new optional request property `preferences/allOf[#/components/schemas/PreferencesRequestDto]/user/oneOf[#/components/schemas/WorkflowPreferencesDto]/all/oneOf[#/components/schemas/WorkflowPreferenceDto]/condition`
  - added the new optional request property `preferences/allOf[#/components/schemas/PreferencesRequestDto]/workflow/allOf[#/components/schemas/WorkflowPreferencesDto]/all/allOf[#/components/schemas/WorkflowPreferenceDto]/condition`
  - added the new optional request property `preferences/allOf[#/components/schemas/PreferencesRequestDto]/workflow/allOf[#/components/schemas/WorkflowPreferencesDto]/all/oneOf[#/components/schemas/WorkflowPreferenceDto]/condition`
  - added the optional property `preferences/allOf[#/components/schemas/WorkflowPreferencesResponseDto]/default/allOf[#/components/schemas/WorkflowPreferencesDto]/all/allOf[#/components/schemas/WorkflowPreferenceDto]/condition` to the response with the `201` status
  - added the optional property `preferences/allOf[#/components/schemas/WorkflowPreferencesResponseDto]/default/allOf[#/components/schemas/WorkflowPreferencesDto]/all/oneOf[#/components/schemas/WorkflowPreferenceDto]/condition` to the response with the `201` status
  - added the optional property `preferences/allOf[#/components/schemas/WorkflowPreferencesResponseDto]/user/allOf[#/components/schemas/WorkflowPreferencesDto]/all/allOf[#/components/schemas/WorkflowPreferenceDto]/condition` to the response with the `201` status
  - added the optional property `preferences/allOf[#/components/schemas/WorkflowPreferencesResponseDto]/user/allOf[#/components/schemas/WorkflowPreferencesDto]/all/oneOf[#/components/schemas/WorkflowPreferenceDto]/condition` to the response with the `201` status
- **2026-08-28** `16a345244098`: 2 breaking
  - the `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/controlValues/allOf[#/components/schemas/EmailControlDto]/preheader` response property's maxLength was unset from `84` for the response status `201`
  - the `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/controls/allOf[#/components/schemas/EmailControlsMetadataResponseDto]/values/allOf[#/components/schemas/EmailControlDto]/preheader` response property's maxLength was unset from `84` for the response status `201`
- **2026-08-16** `c2b2fa0d5d48`: 11 warning, 3 info
  - added the new `CHAT_EDITOR_SELECT` enum value to the `steps/items/oneOf[#/components/schemas/ChatStepResponseDto]/controls/allOf[#/components/schemas/ChatControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `CHAT_EDITOR_SELECT` enum value to the `steps/items/oneOf[#/components/schemas/CustomStepResponseDto]/controls/allOf[#/components/schemas/CustomControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `CHAT_EDITOR_SELECT` enum value to the `steps/items/oneOf[#/components/schemas/DelayStepResponseDto]/controls/allOf[#/components/schemas/DelayControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `CHAT_EDITOR_SELECT` enum value to the `steps/items/oneOf[#/components/schemas/DigestStepResponseDto]/controls/allOf[#/components/schemas/DigestControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `CHAT_EDITOR_SELECT` enum value to the `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/controls/allOf[#/components/schemas/EmailControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `CHAT_EDITOR_SELECT` enum value to the `steps/items/oneOf[#/components/schemas/HttpRequestStepResponseDto]/controls/allOf[#/components/schemas/HttpRequestControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `CHAT_EDITOR_SELECT` enum value to the `steps/items/oneOf[#/components/schemas/InAppStepResponseDto]/controls/allOf[#/components/schemas/InAppControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `CHAT_EDITOR_SELECT` enum value to the `steps/items/oneOf[#/components/schemas/PushStepResponseDto]/controls/allOf[#/components/schemas/PushControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `CHAT_EDITOR_SELECT` enum value to the `steps/items/oneOf[#/components/schemas/SmsStepResponseDto]/controls/allOf[#/components/schemas/SmsControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `CHAT_EDITOR_SELECT` enum value to the `steps/items/oneOf[#/components/schemas/ThrottleStepResponseDto]/controls/allOf[#/components/schemas/ThrottleControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `CHAT_EDITOR_SELECT` enum value to the `steps/items/oneOf[#/components/schemas/ToolStepResponseDto]/controls/allOf[#/components/schemas/ToolControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new optional request property `steps/items/oneOf[#/components/schemas/ChatStepUpsertDto]/controlValues/oneOf[#/components/schemas/ChatControlDto]/editorType`
  - added the optional property `steps/items/oneOf[#/components/schemas/ChatStepResponseDto]/controlValues/allOf[#/components/schemas/ChatControlDto]/editorType` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/ChatStepResponseDto]/controls/allOf[#/components/schemas/ChatControlsMetadataResponseDto]/values/allOf[#/components/schemas/ChatControlDto]/editorType` to the response with the `201` status
- **2026-08-10** `b8c9ccc86d6e`: 22 warning, 22 info
  - added the new `CHAT_CARD_INVALID_BUTTON` enum value to the `steps/items/oneOf[#/components/schemas/ChatStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_INVALID_BUTTON` enum value to the `steps/items/oneOf[#/components/schemas/CustomStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_INVALID_BUTTON` enum value to the `steps/items/oneOf[#/components/schemas/DelayStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_INVALID_BUTTON` enum value to the `steps/items/oneOf[#/components/schemas/DigestStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_INVALID_BUTTON` enum value to the `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_INVALID_BUTTON` enum value to the `steps/items/oneOf[#/components/schemas/HttpRequestStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_INVALID_BUTTON` enum value to the `steps/items/oneOf[#/components/schemas/InAppStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_INVALID_BUTTON` enum value to the `steps/items/oneOf[#/components/schemas/PushStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_INVALID_BUTTON` enum value to the `steps/items/oneOf[#/components/schemas/SmsStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_INVALID_BUTTON` enum value to the `steps/items/oneOf[#/components/schemas/ThrottleStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_INVALID_BUTTON` enum value to the `steps/items/oneOf[#/components/schemas/ToolStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_LIMIT_EXCEEDED` enum value to the `steps/items/oneOf[#/components/schemas/ChatStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_LIMIT_EXCEEDED` enum value to the `steps/items/oneOf[#/components/schemas/CustomStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_LIMIT_EXCEEDED` enum value to the `steps/items/oneOf[#/components/schemas/DelayStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_LIMIT_EXCEEDED` enum value to the `steps/items/oneOf[#/components/schemas/DigestStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_LIMIT_EXCEEDED` enum value to the `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_LIMIT_EXCEEDED` enum value to the `steps/items/oneOf[#/components/schemas/HttpRequestStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_LIMIT_EXCEEDED` enum value to the `steps/items/oneOf[#/components/schemas/InAppStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_LIMIT_EXCEEDED` enum value to the `steps/items/oneOf[#/components/schemas/PushStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_LIMIT_EXCEEDED` enum value to the `steps/items/oneOf[#/components/schemas/SmsStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_LIMIT_EXCEEDED` enum value to the `steps/items/oneOf[#/components/schemas/ThrottleStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `CHAT_CARD_LIMIT_EXCEEDED` enum value to the `steps/items/oneOf[#/components/schemas/ToolStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the optional property `steps/items/oneOf[#/components/schemas/ChatStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/severity` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/ChatStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/integration/additionalProperties/items/severity` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/CustomStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/severity` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/CustomStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/integration/additionalProperties/items/severity` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/DelayStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/severity` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/DelayStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/integration/additionalProperties/items/severity` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/DigestStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/severity` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/DigestStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/integration/additionalProperties/items/severity` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/severity` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/integration/additionalProperties/items/severity` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/HttpRequestStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/severity` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/HttpRequestStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/integration/additionalProperties/items/severity` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/InAppStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/severity` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/InAppStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/integration/additionalProperties/items/severity` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/PushStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/severity` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/PushStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/integration/additionalProperties/items/severity` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/SmsStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/severity` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/SmsStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/integration/additionalProperties/items/severity` to the response with the `201` status
  - …4 more
- **2026-08-04** `ca78ba235703`: 14 info
  - added the new optional request property `agent`
  - added the new optional request property `steps/items/oneOf[#/components/schemas/EmailStepUpsertDto]/controlValues/oneOf[#/components/schemas/EmailControlDto]/from`
  - added the new optional request property `steps/items/oneOf[#/components/schemas/EmailStepUpsertDto]/controlValues/oneOf[#/components/schemas/EmailControlDto]/preheader`
  - added the new optional request property `steps/items/oneOf[#/components/schemas/EmailStepUpsertDto]/controlValues/oneOf[#/components/schemas/EmailControlDto]/replyTo`
  - added the new optional request property `steps/items/oneOf[#/components/schemas/EmailStepUpsertDto]/controlValues/oneOf[#/components/schemas/EmailControlDto]/useProviderDefaults`
  - added the optional property `agent` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/controlValues/allOf[#/components/schemas/EmailControlDto]/from` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/controlValues/allOf[#/components/schemas/EmailControlDto]/preheader` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/controlValues/allOf[#/components/schemas/EmailControlDto]/replyTo` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/controlValues/allOf[#/components/schemas/EmailControlDto]/useProviderDefaults` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/controls/allOf[#/components/schemas/EmailControlsMetadataResponseDto]/values/allOf[#/components/schemas/EmailControlDto]/from` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/controls/allOf[#/components/schemas/EmailControlsMetadataResponseDto]/values/allOf[#/components/schemas/EmailControlDto]/preheader` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/controls/allOf[#/components/schemas/EmailControlsMetadataResponseDto]/values/allOf[#/components/schemas/EmailControlDto]/replyTo` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/controls/allOf[#/components/schemas/EmailControlsMetadataResponseDto]/values/allOf[#/components/schemas/EmailControlDto]/useProviderDefaults` to the response with the `201` status
- **2026-07-31** `8092e41edd57`: 11 breaking, 14 info
  - the `steps/items/oneOf[#/components/schemas/ChatStepResponseDto]/providerOverrides` response's property type changed from no type to `object` for status `201`
  - the `steps/items/oneOf[#/components/schemas/CustomStepResponseDto]/providerOverrides` response's property type changed from no type to `object` for status `201`
  - the `steps/items/oneOf[#/components/schemas/DelayStepResponseDto]/providerOverrides` response's property type changed from no type to `object` for status `201`
  - the `steps/items/oneOf[#/components/schemas/DigestStepResponseDto]/providerOverrides` response's property type changed from no type to `object` for status `201`
  - the `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/providerOverrides` response's property type changed from no type to `object` for status `201`
  - the `steps/items/oneOf[#/components/schemas/HttpRequestStepResponseDto]/providerOverrides` response's property type changed from no type to `object` for status `201`
  - the `steps/items/oneOf[#/components/schemas/InAppStepResponseDto]/providerOverrides` response's property type changed from no type to `object` for status `201`
  - the `steps/items/oneOf[#/components/schemas/PushStepResponseDto]/providerOverrides` response's property type changed from no type to `object` for status `201`
  - the `steps/items/oneOf[#/components/schemas/SmsStepResponseDto]/providerOverrides` response's property type changed from no type to `object` for status `201`
  - the `steps/items/oneOf[#/components/schemas/ThrottleStepResponseDto]/providerOverrides` response's property type changed from no type to `object` for status `201`
  - the `steps/items/oneOf[#/components/schemas/ToolStepResponseDto]/providerOverrides` response's property type changed from no type to `object` for status `201`
  - added the new optional request property `steps/items/oneOf[#/components/schemas/ChatStepUpsertDto]/providerOverrides`
  - added `tool` discriminator mapping keys to the `steps/items/` request property
  - added `#/components/schemas/ToolStepUpsertDto` to the `steps/items/` request property `oneOf` list
  - removed `#/components/schemas/ProviderOverridesDto` from the `steps/items/oneOf[#/components/schemas/ChatStepResponseDto]/providerOverrides` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/ProviderOverridesDto` from the `steps/items/oneOf[#/components/schemas/CustomStepResponseDto]/providerOverrides` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/ProviderOverridesDto` from the `steps/items/oneOf[#/components/schemas/DelayStepResponseDto]/providerOverrides` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/ProviderOverridesDto` from the `steps/items/oneOf[#/components/schemas/DigestStepResponseDto]/providerOverrides` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/ProviderOverridesDto` from the `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/providerOverrides` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/ProviderOverridesDto` from the `steps/items/oneOf[#/components/schemas/HttpRequestStepResponseDto]/providerOverrides` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/ProviderOverridesDto` from the `steps/items/oneOf[#/components/schemas/InAppStepResponseDto]/providerOverrides` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/ProviderOverridesDto` from the `steps/items/oneOf[#/components/schemas/PushStepResponseDto]/providerOverrides` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/ProviderOverridesDto` from the `steps/items/oneOf[#/components/schemas/SmsStepResponseDto]/providerOverrides` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/ProviderOverridesDto` from the `steps/items/oneOf[#/components/schemas/ThrottleStepResponseDto]/providerOverrides` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/ProviderOverridesDto` from the `steps/items/oneOf[#/components/schemas/ToolStepResponseDto]/providerOverrides` response property `allOf` list for the response status `201`
- **2026-07-26** `ab1c5d528f97`: 13 warning, 11 info
  - removed the optional property `steps/items/oneOf[#/components/schemas/ToolStepResponseDto]/controlValues/allOf[#/components/schemas/ToolControlDto]/enabledIntegrations` from the response with the `201` status
  - removed the optional property `steps/items/oneOf[#/components/schemas/ToolStepResponseDto]/controls/allOf[#/components/schemas/ToolControlsMetadataResponseDto]/values/allOf[#/components/schemas/ToolControlDto]/enabledIntegrations` from the response with the `201` status
  - added the new `UNSUPPORTED_PROPERTY` enum value to the `steps/items/oneOf[#/components/schemas/ChatStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `UNSUPPORTED_PROPERTY` enum value to the `steps/items/oneOf[#/components/schemas/CustomStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `UNSUPPORTED_PROPERTY` enum value to the `steps/items/oneOf[#/components/schemas/DelayStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `UNSUPPORTED_PROPERTY` enum value to the `steps/items/oneOf[#/components/schemas/DigestStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `UNSUPPORTED_PROPERTY` enum value to the `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `UNSUPPORTED_PROPERTY` enum value to the `steps/items/oneOf[#/components/schemas/HttpRequestStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `UNSUPPORTED_PROPERTY` enum value to the `steps/items/oneOf[#/components/schemas/InAppStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `UNSUPPORTED_PROPERTY` enum value to the `steps/items/oneOf[#/components/schemas/PushStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `UNSUPPORTED_PROPERTY` enum value to the `steps/items/oneOf[#/components/schemas/SmsStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `UNSUPPORTED_PROPERTY` enum value to the `steps/items/oneOf[#/components/schemas/ThrottleStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the new `UNSUPPORTED_PROPERTY` enum value to the `steps/items/oneOf[#/components/schemas/ToolStepResponseDto]/issues/allOf[#/components/schemas/StepIssuesDto]/controls/additionalProperties/items/issueType` response property for the response status `201`
  - added the optional property `steps/items/oneOf[#/components/schemas/ChatStepResponseDto]/providerOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/CustomStepResponseDto]/providerOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/DelayStepResponseDto]/providerOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/DigestStepResponseDto]/providerOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/providerOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/HttpRequestStepResponseDto]/providerOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/InAppStepResponseDto]/providerOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/PushStepResponseDto]/providerOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/SmsStepResponseDto]/providerOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/ThrottleStepResponseDto]/providerOverrides` to the response with the `201` status
  - added the optional property `steps/items/oneOf[#/components/schemas/ToolStepResponseDto]/providerOverrides` to the response with the `201` status
- **2026-07-21** `c69777f60184`: 1 breaking, 30 warning, 11 info
  - added `#/components/schemas/ToolStepResponseDto` to the `steps/items/` response property `oneOf` list for the response status `201`
  - added the new `TOOL` enum value to the `steps/items/oneOf[#/components/schemas/ChatStepResponseDto]/controls/allOf[#/components/schemas/ChatControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/group` response property for the response status `201`
  - added the new `TOOL` enum value to the `steps/items/oneOf[#/components/schemas/CustomStepResponseDto]/controls/allOf[#/components/schemas/CustomControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/group` response property for the response status `201`
  - added the new `TOOL` enum value to the `steps/items/oneOf[#/components/schemas/DelayStepResponseDto]/controls/allOf[#/components/schemas/DelayControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/group` response property for the response status `201`
  - added the new `TOOL` enum value to the `steps/items/oneOf[#/components/schemas/DigestStepResponseDto]/controls/allOf[#/components/schemas/DigestControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/group` response property for the response status `201`
  - added the new `TOOL` enum value to the `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/controls/allOf[#/components/schemas/EmailControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/group` response property for the response status `201`
  - added the new `TOOL` enum value to the `steps/items/oneOf[#/components/schemas/HttpRequestStepResponseDto]/controls/allOf[#/components/schemas/HttpRequestControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/group` response property for the response status `201`
  - added the new `TOOL` enum value to the `steps/items/oneOf[#/components/schemas/InAppStepResponseDto]/controls/allOf[#/components/schemas/InAppControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/group` response property for the response status `201`
  - added the new `TOOL` enum value to the `steps/items/oneOf[#/components/schemas/PushStepResponseDto]/controls/allOf[#/components/schemas/PushControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/group` response property for the response status `201`
  - added the new `TOOL` enum value to the `steps/items/oneOf[#/components/schemas/SmsStepResponseDto]/controls/allOf[#/components/schemas/SmsControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/group` response property for the response status `201`
  - added the new `TOOL` enum value to the `steps/items/oneOf[#/components/schemas/ThrottleStepResponseDto]/controls/allOf[#/components/schemas/ThrottleControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/group` response property for the response status `201`
  - added the new `TOOL_BODY` enum value to the `steps/items/oneOf[#/components/schemas/ChatStepResponseDto]/controls/allOf[#/components/schemas/ChatControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `TOOL_BODY` enum value to the `steps/items/oneOf[#/components/schemas/CustomStepResponseDto]/controls/allOf[#/components/schemas/CustomControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `TOOL_BODY` enum value to the `steps/items/oneOf[#/components/schemas/DelayStepResponseDto]/controls/allOf[#/components/schemas/DelayControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `TOOL_BODY` enum value to the `steps/items/oneOf[#/components/schemas/DigestStepResponseDto]/controls/allOf[#/components/schemas/DigestControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `TOOL_BODY` enum value to the `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/controls/allOf[#/components/schemas/EmailControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `TOOL_BODY` enum value to the `steps/items/oneOf[#/components/schemas/HttpRequestStepResponseDto]/controls/allOf[#/components/schemas/HttpRequestControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `TOOL_BODY` enum value to the `steps/items/oneOf[#/components/schemas/InAppStepResponseDto]/controls/allOf[#/components/schemas/InAppControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `TOOL_BODY` enum value to the `steps/items/oneOf[#/components/schemas/PushStepResponseDto]/controls/allOf[#/components/schemas/PushControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `TOOL_BODY` enum value to the `steps/items/oneOf[#/components/schemas/SmsStepResponseDto]/controls/allOf[#/components/schemas/SmsControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `TOOL_BODY` enum value to the `steps/items/oneOf[#/components/schemas/ThrottleStepResponseDto]/controls/allOf[#/components/schemas/ThrottleControlsMetadataResponseDto]/uiSchema/allOf[#/components/schemas/UiSchema]/properties/additionalProperties/component` response property for the response status `201`
  - added the new `tool` enum value to the `steps/items/oneOf[#/components/schemas/ChatStepResponseDto]/type` response property for the response status `201`
  - added the new `tool` enum value to the `steps/items/oneOf[#/components/schemas/CustomStepResponseDto]/type` response property for the response status `201`
  - added the new `tool` enum value to the `steps/items/oneOf[#/components/schemas/DelayStepResponseDto]/type` response property for the response status `201`
  - added the new `tool` enum value to the `steps/items/oneOf[#/components/schemas/DigestStepResponseDto]/type` response property for the response status `201`
  - added the new `tool` enum value to the `steps/items/oneOf[#/components/schemas/EmailStepResponseDto]/type` response property for the response status `201`
  - added the new `tool` enum value to the `steps/items/oneOf[#/components/schemas/HttpRequestStepResponseDto]/type` response property for the response status `201`
  - added the new `tool` enum value to the `steps/items/oneOf[#/components/schemas/InAppStepResponseDto]/type` response property for the response status `201`
  - added the new `tool` enum value to the `steps/items/oneOf[#/components/schemas/PushStepResponseDto]/type` response property for the response status `201`
  - added the new `tool` enum value to the `steps/items/oneOf[#/components/schemas/SmsStepResponseDto]/type` response property for the response status `201`
  - added the new `tool` enum value to the `steps/items/oneOf[#/components/schemas/ThrottleStepResponseDto]/type` response property for the response status `201`
  - added the new `tool` enum value to the request property `steps/items/oneOf[#/components/schemas/ChatStepUpsertDto]/type`
  - added the new `tool` enum value to the request property `steps/items/oneOf[#/components/schemas/CustomStepUpsertDto]/type`
  - added the new `tool` enum value to the request property `steps/items/oneOf[#/components/schemas/DelayStepUpsertDto]/type`
  - added the new `tool` enum value to the request property `steps/items/oneOf[#/components/schemas/DigestStepUpsertDto]/type`
  - added the new `tool` enum value to the request property `steps/items/oneOf[#/components/schemas/EmailStepUpsertDto]/type`
  - added the new `tool` enum value to the request property `steps/items/oneOf[#/components/schemas/HttpRequestStepUpsertDto]/type`
  - added the new `tool` enum value to the request property `steps/items/oneOf[#/components/schemas/InAppStepUpsertDto]/type`
  - added the new `tool` enum value to the request property `steps/items/oneOf[#/components/schemas/PushStepUpsertDto]/type`
  - added the new `tool` enum value to the request property `steps/items/oneOf[#/components/schemas/SmsStepUpsertDto]/type`
  - …2 more

---

[Operation](https://skmtc.dev/novu/apis/novu-api/docs/v2/workflows/post.md) - [API](https://skmtc.dev/novu/apis/novu-api.md) - [Page](https://skmtc.dev/novu/apis/novu-api/changes/v2/workflows/post)
