Pular para o conteúdo principal
POST
Criar um token de upload para uploads no navegador
Cria um token de upload que um navegador ou outro cliente não confiável pode usar para enviar arquivos, sem a sua chave de API. O token fixa todas as restrições que você enviar: um path para um arquivo ou um prefix para qualquer arquivo de uma pasta, o maior tamanho, as extensões permitidas e a visibilidade. Ele funciona somente nas rotas de upload, e deixa de funcionar quando a chave de API que o criou é revogada. O token é mostrado uma única vez. Escopo: blob:write.
string
Caminho exato para onde o token pode enviar. Use este ou prefix, não os dois.
string
Pasta para onde o token pode enviar. O sufixo aleatório é forçado. Use este ou path, não os dois.
string
public ou private. Fixado pelo token.
number
Maior arquivo que o token aceita, em bytes.
string[]
De 1 a 20 extensões, em minúsculas, sem o ponto.
string
cache_control fixo para os objetos enviados.
string
inline ou attachment fixo para os objetos enviados.
string
Timestamp ISO 8601 para a exclusão dos objetos enviados.
object
Metadados fixos para os objetos enviados. Enterprise-12 ou superior.
boolean
Permite que os uploads feitos com este token substituam um arquivo existente. Padrão false: sem ele, o token nunca sobrescreve um arquivo que já existe.
number
Segundos que o token fica válido, de 60 a 3600. Padrão 900.
number
Quantos uploads o token permite, de 1 a 100. Padrão 1.
string
O ID do workspace, quando o blob pertence a um workspace. A chamada atua sobre o blob do proprietário do workspace e exige a permissão blob:read do workspace (blob:manage nas rotas que alteram dados). Deixe de fora para atuar sobre o seu próprio blob.

Exemplo de requisição

Resposta

object
O token. Mostrado uma única vez.

Respostas de erro

string
O código de erro que indica o motivo da falha. Valores possíveis:
  • AUTH_TOKEN_MISSING (401): o cabeçalho Authorization não foi enviado.
  • API_KEY_INVALID (401): a chave de API não existe, foi revogada ou o segredo não confere.
  • API_KEY_SCOPE_DENIED (403): a chave não tem o escopo que esta rota exige (blob:read ou blob:write); details.required informa qual.
  • WORKSPACE_PERMISSION_DENIED (403): somente com workspace_id: você não é membro, ou o seu papel não tem a permissão de blob.
  • WORKSPACE_NOT_FOUND (404): somente com workspace_id: não existe workspace com esse ID, ou você não é membro.
  • BLOB_NAMESPACE_SUSPENDED (403): o armazenamento de blob da conta está suspenso, ou o plano expirou. Uploads e outras gravações são recusados desde o início do período de carência de 72 horas.
  • VALIDATION_ERROR (400): um parâmetro ou campo do corpo falhou na validação. details.path informa o campo.
  • PLAN_RESTRICTED_FEATURE (403): metadata foi enviado em um plano abaixo do Enterprise-12.
  • RATE_LIMIT_EXCEEDED (429): mais de 60 tokens criados em um minuto; details.retry_after informa quantos segundos esperar.
Última modificação em 28 de outubro de 2026