Gerar URL de upload de arquivo de um cliente

POST

/v2/files/clients/{clientId}

Gera uma URL assinada para enviar um arquivo do cliente ao armazenamento de documentos. A requisição não tem corpo e a API não recebe o arquivo: use a uploadUrl devolvida para enviá-lo diretamente ao armazenamento. O usuário precisa ter perfil de permissão, e o cliente precisa pertencer à empresa do usuário: cliente inexistente devolve 404 (Cliente não encontrado) e cliente de outra empresa devolve 401 (Acesso negado). Requer autenticação via Bearer JWT ou header x-api-key.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros Header

Respostas

🟢200

application/json

URL assinada para envio do arquivo

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠403Acesso negado

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/v2/files/clients/' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "uploadUrl": "https://storage.example.com/upload?signature=abc"
}

Modificado em 2026-10-13 09:47:06

Página anterior

Gerar URL de download de arquivo da análise AG-IA

Próxima página

Gerar URL de download de arquivo de um cliente