--- title: "Changes to Update an existing automation flow." method: PUT path: "/automation/2026-09-beta/flows/{flowId}" --- # Changes to Update an existing automation flow. `PUT /automation/2026-09-beta/flows/{flowId}` > Every recorded change to this operation, newest first. > 98 revisions in range; 5 not diffed. ## Timeline Changed in 16 of 98 revisions. - **2026-11-13** (2026-09-beta) `6ee0f25fe1ee`: 2 info - **2026-10-29** (2026-09-beta) `bf0e045cbe0f`: 4 info - **2026-10-27** (2026-09-beta) `3e90e93a97ab`: 14 breaking, 14 info - **2026-09-21** (2026-09-beta) `853a7d24d960`: 4 info - **2026-08-21** (2026-09-beta) `2b1538611adf`: 12 breaking, 12 info - **2026-07-13** (2026-09-beta) `437ab7f7961c`: 1 info - **2026-07-13** (2026-09-beta) `614f5ff8daff`: 1 breaking - **2026-05-25** (2026-09-beta) `263473303106`: 14 breaking, 34 info - **2026-05-22** (2026-09-beta) `5f0215d0b5ed`: 1528 breaking, 1528 info - **2026-05-22** (2026-09-beta) `c0e43a548369`: 3 info - **2026-05-20** (2026-09-beta) `03fb9d502442`: 4 breaking, 2 warning, 82 info - **2026-05-18** (2026-09-beta) `1fedd085b0d2`: 3068 breaking, 1589 info - **2026-05-13** (2026-09-beta) `2df047e6bc69`: 822 warning, 822 info - **2026-04-21** (2026-09-beta) `6cc579e23fb8`: 4 info - **2026-04-08** (2026-09-beta) `35d051dad15a`: 1 info - **2026-04-01** (2026-09-beta) `fc7c4f434440`: 1 info ## Changes - **2026-11-13** (2026-09-beta) `6ee0f25fe1ee`: 2 info - the security scope `automation` was added to the endpoint's security scheme `oauth2` - the security scope `workflows.read` was removed from the endpoint's security scheme `oauth2` - **2026-10-29** (2026-09-beta) `bf0e045cbe0f`: 4 info - added the new optional request property `oneOf[#/components/schemas/ApiContactFlowPutRequest]/actions/items/oneOf[subschema #5: WEBHOOK]/body` - added the new optional request property `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/actions/items/oneOf[subschema #5: WEBHOOK]/body` - added the optional property `oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #5: WEBHOOK]/body` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #5: WEBHOOK]/body` to the response with the `200` status - **2026-10-27** (2026-09-beta) `3e90e93a97ab`: 14 breaking, 14 info - added `#/components/schemas/ApiCriteriaBranchAction` to the `oneOf[#/components/schemas/ApiContactFlow]/actions/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiCriteriaBranchAction` to the `oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue/oneOf[subschema #14: LIST]/values/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value/oneOf[subschema #14: LIST]/values/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value/oneOf[subschema #14: LIST]/values/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue/oneOf[subschema #14: LIST]/values/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value/oneOf[subschema #14: LIST]/values/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value/oneOf[subschema #14: LIST]/values/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiCriteriaBranchAction` to the `oneOf[#/components/schemas/ApiContactFlowPutRequest]/actions/items/` request property `oneOf` list - added `#/components/schemas/ApiCriteriaBranchAction` to the `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/actions/items/` request property `oneOf` list - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiContactFlowPutRequest]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue` request property `oneOf` list - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiContactFlowPutRequest]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue/oneOf[subschema #14: LIST]/values/items/` request property `oneOf` list - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiContactFlowPutRequest]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value` request property `oneOf` list - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiContactFlowPutRequest]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value/oneOf[subschema #14: LIST]/values/items/` request property `oneOf` list - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiContactFlowPutRequest]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value` request property `oneOf` list - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiContactFlowPutRequest]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value/oneOf[subschema #14: LIST]/values/items/` request property `oneOf` list - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue` request property `oneOf` list - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue/oneOf[subschema #14: LIST]/values/items/` request property `oneOf` list - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value` request property `oneOf` list - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value/oneOf[subschema #14: LIST]/values/items/` request property `oneOf` list - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value` request property `oneOf` list - added `#/components/schemas/ApiMultiValue` to the `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value/oneOf[subschema #14: LIST]/values/items/` request property `oneOf` list - **2026-09-21** (2026-09-beta) `853a7d24d960`: 4 info - added the new optional request property `oneOf[#/components/schemas/ApiContactFlowPutRequest]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/staticBranches/items/operator` - added the new optional request property `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/staticBranches/items/operator` - added the optional property `oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/staticBranches/items/operator` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/staticBranches/items/operator` to the response with the `200` status - **2026-08-21** (2026-09-beta) `2b1538611adf`: 12 breaking, 12 info - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue/oneOf[subschema #12: LIST -> subschema #14: LIST]/values/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value/oneOf[subschema #12: LIST -> subschema #14: LIST]/values/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value/oneOf[subschema #12: LIST -> subschema #14: LIST]/values/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue/oneOf[subschema #12: LIST -> subschema #14: LIST]/values/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value/oneOf[subschema #12: LIST -> subschema #14: LIST]/values/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value/oneOf[subschema #12: LIST -> subschema #14: LIST]/values/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiContactFlowPutRequest]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue` request property `oneOf` list - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiContactFlowPutRequest]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue/oneOf[subschema #12: LIST -> subschema #14: LIST]/values/items/` request property `oneOf` list - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiContactFlowPutRequest]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value` request property `oneOf` list - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiContactFlowPutRequest]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value/oneOf[subschema #12: LIST -> subschema #14: LIST]/values/items/` request property `oneOf` list - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiContactFlowPutRequest]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value` request property `oneOf` list - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiContactFlowPutRequest]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value/oneOf[subschema #12: LIST -> subschema #14: LIST]/values/items/` request property `oneOf` list - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue` request property `oneOf` list - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue/oneOf[subschema #12: LIST -> subschema #14: LIST]/values/items/` request property `oneOf` list - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value` request property `oneOf` list - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value/oneOf[subschema #12: LIST -> subschema #14: LIST]/values/items/` request property `oneOf` list - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value` request property `oneOf` list - added `#/components/schemas/ApiEnrollmentDatasetColumnValue, #/components/schemas/ApiSingleObjectCoordinatesValue` to the `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value/oneOf[subschema #12: LIST -> subschema #14: LIST]/values/items/` request property `oneOf` list - **2026-07-13** (2026-09-beta) `437ab7f7961c`: 1 info - endpoint added - **2026-07-13** (2026-09-beta) `614f5ff8daff`: 1 breaking - api path removed without deprecation - **2026-05-25** (2026-09-beta) `263473303106`: 14 breaking, 34 info - the request property `oneOf[#/components/schemas/ApiContactFlowPutRequest]/actions` became required - the request property `oneOf[#/components/schemas/ApiContactFlowPutRequest]/blockedDates` became required - the request property `oneOf[#/components/schemas/ApiContactFlowPutRequest]/canEnrollFromSalesforce` became required - the request property `oneOf[#/components/schemas/ApiContactFlowPutRequest]/customProperties` became required - the request property `oneOf[#/components/schemas/ApiContactFlowPutRequest]/isEnabled` became required - the request property `oneOf[#/components/schemas/ApiContactFlowPutRequest]/revisionId` became required - the request property `oneOf[#/components/schemas/ApiContactFlowPutRequest]/suppressionListIds` became required - the request property `oneOf[#/components/schemas/ApiContactFlowPutRequest]/timeWindows` became required - the request property `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/actions` became required - the request property `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/blockedDates` became required - the request property `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/customProperties` became required - the request property `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/isEnabled` became required - the request property `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/revisionId` became required - the request property `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/timeWindows` became required - the request property `oneOf[#/components/schemas/ApiContactFlowPutRequest]/type` with a default value became required - the request property `oneOf[#/components/schemas/ApiPlatformFlowPutRequest]/type` with a default value became required - the response property `oneOf[#/components/schemas/ApiContactFlow]/actions` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiContactFlow]/blockedDates` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiContactFlow]/canEnrollFromSalesforce` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiContactFlow]/createdAt` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiContactFlow]/crmObjectCreationStatus` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiContactFlow]/customProperties` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiContactFlow]/dataSources` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiContactFlow]/flowType` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiContactFlow]/id` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiContactFlow]/isEnabled` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiContactFlow]/nextAvailableActionId` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiContactFlow]/objectTypeId` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiContactFlow]/revisionId` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiContactFlow]/suppressionListIds` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiContactFlow]/timeWindows` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiContactFlow]/type` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiContactFlow]/updatedAt` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiPlatformFlow]/actions` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiPlatformFlow]/blockedDates` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiPlatformFlow]/createdAt` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiPlatformFlow]/crmObjectCreationStatus` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiPlatformFlow]/customProperties` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiPlatformFlow]/dataSources` became required for the status `200` - the response property `oneOf[#/components/schemas/ApiPlatformFlow]/flowType` became required for the status `200` - …8 more - …earlier changes are on the page: https://skmtc.dev/hubspot/apis/automation-automation-v4/changes/automation/2026-09-beta/flows/:flowId/put --- [Operation](https://skmtc.dev/hubspot/apis/automation-automation-v4/docs/automation/2026-09-beta/flows/:flowId/put.md) - [API](https://skmtc.dev/hubspot/apis/automation-automation-v4.md) - [Page](https://skmtc.dev/hubspot/apis/automation-automation-v4/changes/automation/2026-09-beta/flows/:flowId/put)