Enviar um documento

Envia um documento do cadastro. O arquivo é guardado e encaminhado para análise; a resposta diz se ele foi aceito para processar.

POSThttps://api.navenaut.com/kyc/documents

Autenticação

A sessão do painel autentica esta rota, e ela é lida de forma autoritativa: não há parâmetro em que o chamador aponte para outra conta.

Esta rota não exige escopo nomeado — o que não quer dizer que ela seja aberta: sem a credencial acima ela recusa.

Exige sessão de vendedor. A conta lida e escrita é sempre a da sessão: não há campo em que o chamador escolha outra.

application/json.

Campo	Tipo	Descrição
`file`obrigatório	texto (binary)	O arquivo em si. Há limite de tamanho e de tipo, e os dois recusam com status próprio.
`kind`obrigatório	um de: `identity_front`, `identity_back`, `selfie`, `proof_of_address`, `company_bylaws`, `proof_of_bank_account`	Que documento é este. Cada tipo só pode ser enviado enquanto o cadastro o aceita.

{
  "file": "exemplo",
  "kind": "identity_front"
}

{
  "byteSize": 0,
  "contentType": "image/jpeg",
  "kind": "identity_front",
  "uploadedAt": "2026-01-15T12:00:00.000Z"
}

O documento não passou na validação de conteúdo.

O arquivo passou do tamanho aceito.

O tipo de arquivo não é aceito.

Status	Código	Quando	O que fazer
400	`KYC_DOCUMENT_REFUSED`	O arquivo foi recusado antes de ser guardado, e quem separa as três causas é `reason`, não o código: `empty` responde 400 e é arquivo vazio, `too_large` responde 413 e é arquivo acima do tamanho aceito, `content_type` responde 415 e é tipo de arquivo que não aceitamos. O código é o mesmo nos três porque a classe de recusa é uma só; o que muda é o status e o motivo.	Leia `reason` antes de repetir, porque o conserto é diferente em cada um: mande um arquivo com conteúdo, um arquivo menor, ou um arquivo do tipo aceito. Reenviar o mesmo arquivo devolve sempre a mesma recusa, e nada foi guardado.

Os códigos são estáveis e fazem parte do contrato. A lista completa, com todos os vocabulários, está na tabela de erros.