Saltar al contenido principal
PATCH
/
files
/
v3
/
folders
/
{folderId}
Actualizar propiedades de carpeta por ID de carpeta
curl --request PATCH \
  --url https://api.hubapi.com/files/v3/folders/{folderId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "parentFolderId": 123
}
'
{
  "archived": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z",
  "archivedAt": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "parentFolderId": "<string>",
  "path": "<string>"
}

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.

Path Parameters

folderId
string
required

Body

application/json

Object for updating folders.

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.

Response

successful operation

archived
boolean
required

Marca si la carpeta está eliminada o no.

createdAt
string<date-time>
required

Marca de tiempo de la creación de la carpeta.

id
string
required

ID de la carpeta.

updatedAt
string<date-time>
required

Marca de tiempo de la última actualización de la carpeta.

archivedAt
string<date-time>

Marca de tiempo de la eliminación de la carpeta.

name
string

Nombre de la carpeta.

parentFolderId
string

ID de la carpeta principal.

path
string

Ruta de la carpeta en el administrador de archivos.

Last modified on December 8, 2025