Skip to main content
POST
Upload de Arquivo

POST /files

Faz upload de um novo arquivo para o sistema e opcionalmente o processa.
Máximo de 32 MB por arquivo neste endpoint. Esta chamada single-shot POST /files envia o corpo do arquivo através do servidor da API, que tem um limite rígido de 32 MB no tamanho do corpo de requisições HTTP de entrada. Arquivos maiores que 32 MB são rejeitados antes de chegarem à camada da aplicação.Para arquivos maiores que 32 MB, utilize o fluxo de upload assinado v2. Ele envia o corpo do arquivo diretamente do seu cliente para o Google Cloud Storage (o servidor da API fica fora do caminho dos bytes) e aceita arquivos de até 200 MB.

Arquivos suportados

Limites

  • Tamanho máximo de arquivo por upload neste endpoint: 32 MB (limite de tamanho de requisição HTTP da plataforma). Para arquivos de até 200 MB, use o fluxo de upload assinado v2.
  • Este endpoint aceita um arquivo por solicitação (use várias solicitações para vários arquivos).
  • Limite de armazenamento de arquivos: 30 arquivos
  • Alguns recursos têm limites diferentes:
    • Anexos de bate-papo: até 200 MB por arquivo via o fluxo de upload assinado v2; até 5 arquivos por envio
    • Transcrição de áudio: até 10 MB por arquivo

Exemplos de Código

Cabeçalhos

integer
obrigatório
ID do workspace. Obrigatório a partir de 01/09/2026. Até lá, se omitido, usa o workspace selecionado do usuário (deprecated). Após a data, ausência → 422.

Parâmetros do Corpo

O playground não suporta uploads multipart/form-data diretamente. Use os Exemplos de Código acima (cURL, Python, Node.js, etc.) para enviar o arquivo. Os campos abaixo são exibidos apenas para documentação.
file
obrigatório
O arquivo a ser enviado (multipart/form-data)
boolean
Se deve processar o arquivo após o upload (padrão: false). O processamento consome créditos (true).

Resposta