Skip to main content
POST
Iniciar upload de vídeo
Envie title. A resposta contém o objeto asset completo com o campo adicional upload; envie os bytes pelo método indicado e confirme. O vídeo pode continuar em processamento após a confirmação. Requer assets:write ou write. Use Idempotency-Key ao repetir a mesma operação. Veja campos, relacionamentos e eventos.

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string

Chave única por operação lógica, de 1 a 255 caracteres ASCII imprimíveis, sem espaços. Reutilize-a somente para repetir a mesma operação.

Required string length: 1 - 255

Body

application/json
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.

Required string length: 1 - 300
description
string | null

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

Maximum string length: 10000
metadata
object

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.

size_bytes
integer

Tamanho original em bytes. Obrigatório quando a plataforma define uma cota ou limite por arquivo; reserva armazenamento e é conferido após o upload.

Required range: x >= 0

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.

upload
object
required

Credencial temporária incluída somente na resposta de criação do upload. Os campos do asset permanecem na raiz da resposta.

video
object | null
required

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