Saltar al contenido principal
GET
/
files
/
v3
/
folders
/
update
/
async
/
tasks
/
{taskId}
/
status
Verificar estado de actualización de la carpeta
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>"
  }
}

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.

Parámetros de ruta

taskId
string
requerido

El ID de la tarea de actualización de la carpeta.

Respuesta

successful operation

completedAt
string<date-time>
requerido

Cuando se hayan completado los cambios solicitados.

startedAt
string<date-time>
requerido

Marca de tiempo que representa cuándo se inició la tarea.

status
enum<string>
requerido

Estado actual de la tarea.

Opciones disponibles:
CANCELED,
COMPLETE,
PENDING,
PROCESSING
taskId
string
requerido

ID de la tarea.

errors
object[]

Errores detallados resultantes de la tarea.

Enlace para comprobar el estado de la tarea.

numErrors
integer<int32>

Número de errores resultantes de los cambios solicitados.

requestedAt
string<date-time>

Marca de tiempo que representa cuándo se solicitó la tarea.

result
object
Last modified on January 26, 2026