Saltar al contenido principal
POST
/
files
/
v3
/
folders
/
update
/
async
Actualizar propiedades de carpeta
curl --request POST \
  --url https://api.hubapi.com/files/v3/folders/update/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>",
  "name": "<string>",
  "parentFolderId": 123
}
'
{
  "id": "57122e26-59f8-4cfc-ba53-96e30c816762",
  "links": [
    {
      "status": "https://api.hubspot.com/files/v3/folders/update/async/tasks/57122e26-59f8-4cfc-ba53-96e30c816762/status"
    }
  ]
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Gratuito
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Gratuito

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

El identificador único de la carpeta que se actualizará.

name
string

El nuevo nombre de la carpeta, que también actualizará el fullPath y todos los elementos de la carpeta.

parentFolderId
integer<int64>

El ID de la nueva carpeta principal, que moverá la carpeta y sus elementos a la carpeta especificada.

Response

accepted

Information on the task that has been started, and where to check it's status.

id
string
required

ID de la tarea

Enlaces para consultar información relacionada con la tarea. El enlace "status" proporciona la URL para comprobar el estado de la tarea.

Last modified on December 8, 2025