Pular para o conteúdo principal
POST
/
files
/
v3
/
folders
/
update
/
async
Atualizar propriedades da pasta
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"
    }
  ]
}

Produtos suportados

Requer um dos seguintes produtos ou superior.
Marketing HubMarketing Hub -Grátis
Sales HubSales Hub -Grátis
Service HubService Hub -Grátis
Content HubContent Hub -Grátis

Autorizações

Authorization
string
header
obrigatório

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

Corpo

application/json
id
string
obrigatório

O identificador exclusivo da pasta a ser atualizada.

name
string

O novo nome. Se especificado, o nome da pasta e fullPath serão alterados. Todos os objetos secundários serão atualizados de acordo.

parentFolderId
integer<int64>

O folderId da nova pasta principal. Se alterado, a pasta e todos os seus objetos secundários serão movidos para a pasta especificada. parentFolderId e parentFolderPath não podem ser especificados ao mesmo tempo.

Resposta

accepted

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

id
string
obrigatório

ID da tarefa

Links para verificar informações relacionadas à tarefa. O link "status" fornece o URL para verificar o status da tarefa.

Last modified on March 24, 2026