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

Authorizations

Authorization
string
header
required

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

Path Parameters

taskId
string
required

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

Response

successful operation

completedAt
string<date-time>
required

Cuando se hayan completado los cambios solicitados.

startedAt
string<date-time>
required

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

status
enum<string>
required

Estado actual de la tarea.

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

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 December 8, 2025