Skip to main content
POST
/
files
/
2026-03
/
folders
/
update
/
async
Update folder properties
curl --request POST \
  --url https://api.hubapi.com/files/2026-03/folders/update/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>",
  "name": "<string>",
  "parentFolderId": 123
}
'
{
  "id": "<string>",
  "links": {}
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Supported products

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
id
string
required

The unique identifier of the folder to be updated.

​
name
string

New name. If specified the folder's name and fullPath will change. All children of the folder will be updated accordingly.

​
parentFolderId
integer<int64>

New parent folderId. If changed, the folder and all it's children will be moved into the specified folder. parentFolderId and parentFolderPath cannot be specified at the same time.

Response

accepted

​
id
string
required

ID of the task

​
links
object

Links for where to check information related to the task. The status link gives the URL for where to check the status of the task.

Last modified on March 30, 2026