Skip to main content
GET
Obter um arquivo
Retorna o objeto completo identificado pelo ID, quando ele pertence à conta da chave. Requer assets:read ou read. Veja campos, relacionamentos e eventos.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

ID público do arquivo na conta.

Pattern: ^ast_[a-z0-9]{16}$

Response

Operação concluída

id
string
required

Identificador público estável. Use o valor retornado pela API nas consultas e relacionamentos; não derive IDs de nomes.

Pattern: ^ast_[a-z0-9]{16}$
created_at
string<date-time>
required

Data e hora da criação, em ISO 8601 com fuso horário. Somente leitura.

description
string | null
required

Descrição do item. Pode ser null; envie null para limpar.

file
object | null
required

Detalhes do arquivo quando type é file. Null para vídeos. Somente leitura.

metadata
object
required

Objeto JSON livre para referências da integração, limitado a 16 KB. Ao enviar, substitui todo o metadata anterior; use {} para limpar. Não aceita null.

mime_type
string | null
required

Tipo MIME do arquivo, como application/pdf. Pode ser null. Informado no início do upload de arquivo; não é editável depois.

object
string
required

Tipo do objeto retornado. O valor é fixo para este recurso.

Allowed value: "asset"
size_bytes
integer | null
required

Tamanho do conteúdo em bytes, preenchido pela verificação/processamento. Pode ser null enquanto desconhecido. Somente leitura.

status
enum<string>
required

Estado do envio: uploading, processing, ready ou failed. deleted indica exclusão; itens excluídos não aparecem nas consultas normais. Somente leitura.

Available options:
uploading,
processing,
ready,
failed,
deleted
title
string
required

Título do item na biblioteca. Obrigatório na criação, não vazio e com até 300 caracteres no início do upload.

type
enum<string>
required

Variante do conteúdo: file ou video. Definida pela operação de criação e não editável.

Available options:
file,
video
updated_at
string<date-time>
required

Data e hora da última alteração, em ISO 8601 com fuso horário. Somente leitura.

video
object | null
required

Detalhes do vídeo quando type é video. Null para arquivos. Somente leitura.