Upload public key

post

https://api.autra.io/v1/tenants/{tenantID}/keys

Registra uma chave pública RSA do tenant e retorna um challengeNonce
que deve ser assinado no passo seguinte via
POST /v1/tenants/{tenantID}/keys/{keyID}/verify.

Formato: PEM PKIX (SubjectPublicKeyInfo). Tamanho recomendado 2048 bits ou superior.

Content-Type: multipart/form-data com o campo file contendo o PEM.

Expiração: o challengeNonce vale por 30 minutos. Passado esse prazo o
registro fica expired e é necessário refazer o upload.

Múltiplas chaves verificadas por tenant são permitidas (útil para rotação).
O 409 PENDING_KEY_EXISTS só é retornado quando já existe uma chave em estado
pending dentro da janela de 30 min.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

Código	Motivo
sem code	`tenantID is required` — path param ausente
sem code	`Invalid tenantID (UUID required)` — path param não é UUID
sem code	`Failed to decode base64 body: ...` — body base64 inválido quando API Gateway sinaliza `isBase64Encoded`
`INVALID_MULTIPART_REQUEST`	Boundary ausente OU multipart não parseou
`MISSING_FILE`	Campo `file` ausente no multipart
`EMPTY_PUBLIC_KEY`	Arquivo de chave vazio
`INVALID_PEM_FORMAT`	PEM não é RSA público válido
sem code	`Invalid public key (DER decode failed)` — bytes internos do PEM inválidos
sem code	`Tenant not found` — tenant não existe

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Chave registrada — challenge gerado.

403Tenant inativo (status ≠ APPROVED) OU IP não está na allowlist do tenant.

409Já existe uma chave pending (não verificada) para este tenant, dentro da janela de 30 minutos. Após expiração o próximo upload é permitido normalmente. Não bloqueia chaves já verified (múltiplas verificadas são permitidas para rotação).

500Erro interno (banco indisponível, falha ao ler arquivo, etc). Corpo pode variar.