Skip to main content
POST
Atualizar um arquivo
Apenas description, metadata e title são editáveis. 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

Path Parameters

id
string
required

ID público do arquivo na conta.

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

Body

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

title
string

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 - 10000

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.