POST
/
cms
/
v3
/
pages
/
landing-pages
/
folders
/
batch
/
read
Retrieve a batch of Folders
curl --request POST \
  --url https://api.hubapi.com/cms/v3/pages/landing-pages/folders/batch/read \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "inputs": [
    "<string>"
  ]
}'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "requestedAt": "2023-11-07T05:31:56Z",
  "startedAt": "2023-11-07T05:31:56Z",
  "links": {},
  "results": [
    {
      "deletedAt": "2023-11-07T05:31:56Z",
      "parentFolderId": 123,
      "created": "2023-11-07T05:31:56Z",
      "name": "<string>",
      "id": "<string>",
      "category": 123,
      "updated": "2023-11-07T05:31:56Z"
    }
  ],
  "status": "PENDING"
}
Supported products
Requires one of the following products or higher.
Marketing HubMarketing HubFree
Sales HubSales HubFree
Service HubService HubFree
Content HubContent HubFree

​
Required Scopes

This API requires one of the following scopes:
  • content

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

​
archived
boolean

Specifies whether to return deleted Folders. Defaults to false.

Body

application/json

The JSON array of Folder ids.

Wrapper for providing an array of strings as inputs.

Response

200
application/json

successful operation

Response object for successful batch operations on content folders.