Pular para o conteúdo principal
GET
/
files
/
v3
/
folders
/
update
/
async
/
tasks
/
{taskId}
/
status
Verificar status de atualização da pasta
curl --request GET \
  --url https://api.hubapi.com/files/v3/folders/update/async/tasks/{taskId}/status \
  --header 'Authorization: Bearer <token>'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "startedAt": "2023-11-07T05:31:56Z",
  "status": "CANCELED",
  "taskId": "<string>",
  "errors": [
    {
      "category": "<string>",
      "context": {},
      "errors": [
        {
          "message": "<string>",
          "code": "<string>",
          "context": "{missingScopes=[scope1, scope2]}",
          "in": "<string>",
          "subCategory": "<string>"
        }
      ],
      "links": {},
      "message": "<string>",
      "status": "<string>",
      "id": "<string>",
      "subCategory": {}
    }
  ],
  "links": {},
  "numErrors": 123,
  "requestedAt": "2023-11-07T05:31:56Z",
  "result": {
    "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>"
  }
}

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.

Parâmetros de caminho

taskId
string
obrigatório

TaskId da atualização da pasta

Resposta

successful operation

completedAt
string<date-time>
obrigatório

Quando as alterações solicitadas forem concluídas.

startedAt
string<date-time>
obrigatório

A data e hora que representa quando a tarefa foi iniciada.

status
enum<string>
obrigatório

O status atual da tarefa.

Opções disponíveis:
CANCELED,
COMPLETE,
PENDING,
PROCESSING
taskId
string
obrigatório

O ID da tarefa.

errors
object[]

Erros detalhados resultantes da tarefa.

Link para verificar o status da tarefa.

numErrors
integer<int32>

Número de erros resultantes das alterações solicitadas.

requestedAt
string<date-time>

A data e hora que representa quando a tarefa foi solicitada.

result
object
Last modified on March 24, 2026