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

Autorizaciones

Authorization
string
header
requerido

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

Cuerpo

application/json
id
string
requerido

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

name
string

Nuevo nombre. Si se especifica, el nombre de la carpeta y el parámetro fullPath cambiarán. Todos los elementos de la carpeta se actualizarán en consecuencia.

parentFolderId
integer<int64>

Nuevo folderId principal. Si se cambia, la carpeta y todos sus elementos se moverán a la carpeta especificada. Los parámetros parentFolderId y parentFolderPath no se pueden especificar al mismo tiempo.

Respuesta

accepted

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

id
string
requerido

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 March 19, 2026