Saltar al contenido principal
GET
/
files
/
v3
/
files
/
import-from-url
/
async
/
tasks
/
{taskId}
/
status
Verificar estado de importación
curl --request GET \
  --url https://api.hubapi.com/files/v3/files/import-from-url/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": {
    "access": "HIDDEN_INDEXABLE",
    "archived": true,
    "createdAt": "2023-11-07T05:31:56Z",
    "id": "<string>",
    "updatedAt": "2023-11-07T05:31:56Z",
    "archivedAt": "2023-11-07T05:31:56Z",
    "defaultHostingUrl": "<string>",
    "encoding": "<string>",
    "expiresAt": 123,
    "extension": "<string>",
    "fileMd5": "<string>",
    "height": 123,
    "isUsableInContent": true,
    "name": "<string>",
    "parentFolderId": "<string>",
    "path": "<string>",
    "size": 123,
    "sourceGroup": "<string>",
    "type": "<string>",
    "url": "<string>",
    "width": 123
  }
}

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

ID de tarea Importar por URL

Respuesta

successful operation

completedAt
string<date-time>
requerido

Hora de finalización de la tarea.

startedAt
string<date-time>
requerido

Marca de tiempo de cuando 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 solicitada.

errors
object[]

Mensajes de error descriptivos.

Enlace para comprobar el estado de la tarea solicitada.

numErrors
integer<int32>

Número de errores resultantes de la tarea.

requestedAt
string<date-time>

Marca de tiempo de cuando se solicitó la tarea.

result
object

File

Last modified on January 26, 2026