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": {}
}

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

The new name for the folder, which will also update the fullPath and all children of the folder.

​
parentFolderId
integer<int64>

The ID of the new parent folder, which will move the folder and its children into the specified folder.

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