---
title: "Changes to Retrieve multiple automation flows in a single request."
method: POST
path: "/automation/2026-09-beta/flows/batch/read"
---

# Changes to Retrieve multiple automation flows in a single request.

`POST /automation/2026-09-beta/flows/batch/read`

> Every recorded change to this operation, newest first.
> 98 revisions in range; 5 not diffed.

## Timeline

Changed in 18 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`: 28 breaking
- **2026-09-21** (2026-09-beta) `853a7d24d960`: 4 info
- **2026-09-10** (2026-09-beta) `cfb0202a7f99`: 12224 breaking
- **2026-08-21** (2026-09-beta) `2b1538611adf`: 24 breaking
- **2026-08-14** (2026-09-beta) `1785447277fb`: 12236 breaking
- **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`: 64 info
- **2026-05-22** (2026-09-beta) `5f0215d0b5ed`: 3056 info
- **2026-05-22** (2026-09-beta) `c0e43a548369`: 3 info
- **2026-05-20** (2026-09-beta) `03fb9d502442`: 4 breaking, 100 info
- **2026-05-18** (2026-09-beta) `1fedd085b0d2`: 6136 info
- **2026-05-13** (2026-09-beta) `2df047e6bc69`: 1644 warning
- **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 optional property `results/items/oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #5: WEBHOOK]/body` to the response with the `200` status
  - added the optional property `results/items/oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #5: WEBHOOK]/body` to the response with the `207` status
  - added the optional property `results/items/oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #5: WEBHOOK]/body` to the response with the `200` status
  - added the optional property `results/items/oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #5: WEBHOOK]/body` to the response with the `207` status
- **2026-10-27** (2026-09-beta) `3e90e93a97ab`: 28 breaking
  - added `#/components/schemas/ApiCriteriaBranchAction` to the `results/items/oneOf[#/components/schemas/ApiContactFlow]/actions/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/ApiCriteriaBranchAction` to the `results/items/oneOf[#/components/schemas/ApiContactFlow]/actions/items/` response property `oneOf` list for the response status `207`
  - added `#/components/schemas/ApiCriteriaBranchAction` to the `results/items/oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/ApiCriteriaBranchAction` to the `results/items/oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/` response property `oneOf` list for the response status `207`
  - added `#/components/schemas/ApiMultiValue` to the `results/items/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 `results/items/oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue` response property `oneOf` list for the response status `207`
  - added `#/components/schemas/ApiMultiValue` to the `results/items/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 `results/items/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 `207`
  - added `#/components/schemas/ApiMultiValue` to the `results/items/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 `results/items/oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value` response property `oneOf` list for the response status `207`
  - added `#/components/schemas/ApiMultiValue` to the `results/items/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 `results/items/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 `207`
  - added `#/components/schemas/ApiMultiValue` to the `results/items/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 `results/items/oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value` response property `oneOf` list for the response status `207`
  - added `#/components/schemas/ApiMultiValue` to the `results/items/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 `results/items/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 `207`
  - added `#/components/schemas/ApiMultiValue` to the `results/items/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 `results/items/oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/inputValue` response property `oneOf` list for the response status `207`
  - added `#/components/schemas/ApiMultiValue` to the `results/items/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 `results/items/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 `207`
  - added `#/components/schemas/ApiMultiValue` to the `results/items/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 `results/items/oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #4: CUSTOM_CODE]/inputFields/items/value` response property `oneOf` list for the response status `207`
  - added `#/components/schemas/ApiMultiValue` to the `results/items/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 `results/items/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 `207`
  - added `#/components/schemas/ApiMultiValue` to the `results/items/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 `results/items/oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #5: WEBHOOK]/queryParams/items/value` response property `oneOf` list for the response status `207`
  - added `#/components/schemas/ApiMultiValue` to the `results/items/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/ApiMultiValue` to the `results/items/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 `207`
- **2026-09-21** (2026-09-beta) `853a7d24d960`: 4 info
  - added the optional property `results/items/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 `results/items/oneOf[#/components/schemas/ApiContactFlow]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/staticBranches/items/operator` to the response with the `207` status
  - added the optional property `results/items/oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/staticBranches/items/operator` to the response with the `200` status
  - added the optional property `results/items/oneOf[#/components/schemas/ApiPlatformFlow]/actions/items/oneOf[subschema #1: STATIC_BRANCH]/staticBranches/items/operator` to the response with the `207` status
- …earlier changes are on the page: https://skmtc.dev/hubspot/apis/automation-automation-v4/changes/automation/2026-09-beta/flows/batch/read/post

---

[Operation](https://skmtc.dev/hubspot/apis/automation-automation-v4/docs/automation/2026-09-beta/flows/batch/read/post.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/batch/read/post)