Revogar uma chave de API
Revoga a chave imediatamente. A próxima chamada que a apresentar é recusada, sem período de graça.
DELETEhttps://api.navenaut.com/api-keys/{id}
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 chave de API não autentica esta rota: uma chave não pode emitir nem revogar outra chave.
Parâmetros
Caminho
| Nome | Tipo | Descrição |
|---|---|---|
idobrigatório | texto | O identificador da chave, como ele aparece na listagem. Nunca o segredo. |
Respostas
200 · sucesso
{
"id": "0f2a4e6c-91c4-4e1b-9a3d-5b7c2e8f4a06",
"revokedAt": "2026-01-15T12:00:00.000Z"
}404 · não encontrado
A chave não existe, ou não é sua.
Erros desta rota
| Status | Código | Quando | O que fazer |
|---|---|---|---|
| 404 | API_KEY_NOT_FOUND | O identificador não existe, ou a chave é de outra conta. As duas causas respondem igual de propósito: distinguir revelaria a existência de chave alheia. | Confira o identificador na listagem de chaves. Repetir não muda o resultado, e nenhuma chave foi revogada. |
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.