Zum Hauptinhalt springen
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 '{
  "parentFolderId": 123,
  "name": "<string>",
  "id": "<string>"
}'
{
  "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 HubGrátis
Sales HubSales HubGrátis
Service HubService HubGrátis
Content HubContent HubStarter

​
Escopos Necessários

Esta API requer um dos seguintes escopos:
  • files

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

O identificador exclusivo da pasta a ser atualizada.

​
parentFolderId
integer

O ID da nova pasta principal, que moverá a pasta e seus objetos secundários para a pasta especificada.

​
name
string

O novo nome da pasta, que também atualizará o fullPath e todos os objetos secundários da pasta.

Response

accepted

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

​
links
object
required

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

Example:

"[{\"status\":\"https://api.hubspot.com/files/v3/folders/update/async/tasks/57122e26-59f8-4cfc-ba53-96e30c816762/status\"}]"

​
id
string
required

ID da tarefa

Example:

"57122e26-59f8-4cfc-ba53-96e30c816762"

⌘I