Arquivos
Upload, verificação antivírus e download de arquivos.
Criar arquivo e URL de envio
Registra o arquivo (`module`, `mime`, `size_bytes`, `checksum` opcional) e devolve uma URL pré-assinada `put_url` com os cabeçalhos para enviar o conteúdo diretamente ao armazenamento. Requer a permissão `files.objects.write`. Tipo de arquivo não permitido ou acima de 25 MB retorna `400`.
Listar arquivos
Lista os arquivos da organização. Requer a permissão `files.objects.read`. Listagem paginada no envelope `{items, page}` com `limit`/`cursor` (também aceita `sort`, `q` e `filter`).
Consultar arquivo
Retorna os metadados do arquivo (tipo, tamanho, checksum, autor, data). Requer a permissão `files.objects.read`. O `file_id` é o código público de 4 caracteres do arquivo; inexistente retorna `404`.
Excluir arquivo
Exclui o registro e o conteúdo armazenado do arquivo; responde `204`. Requer a permissão `files.objects.write`. O `file_id` é o código público de 4 caracteres do arquivo; inexistente retorna `404`.
Confirmar envio de arquivo
Confirma que o conteúdo enviado tem o tamanho e o tipo declarados na criação; responde `204`, ou `409` `upload_incomplete` quando o envio não confere. Requer a permissão `files.objects.write`. O `file_id` é o código público de 4 caracteres do arquivo; inexistente retorna `404`.
Gerar URL de download do arquivo
Devolve uma URL pré-assinada temporária (`url`, `expires_in`) para baixar o conteúdo. Requer a permissão `files.objects.read`. O `file_id` é o código público de 4 caracteres do arquivo; inexistente retorna `404`.