Pular para o conteúdo principal
GET
/
files
/
v3
/
files
/
import-from-url
/
async
/
tasks
/
{taskId}
/
status
Verificar status de importação
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": "CONTENT",
    "type": "<string>",
    "url": "<string>",
    "width": 123
  }
}

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
Esta API requer um dos seguintes escopos:
files
files.ui_hidden.read

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

Importar por ID de tarefa do URL

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[]

Mensagens de erro descritivas.

Link para verificar o status da tarefa solicitada.

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

File

Last modified on March 24, 2026