Referencia APIAPI Keys
Eliminar API Key
DELETE /api/v1/contribuyentes/:contribuyenteId/api-keys/:id — revocá permanentemente un API key.
DELETE /api/v1/contribuyentes/:contribuyenteId/api-keys/:id
Elimina permanentemente un API key. La clave queda revocada y no puede recuperarse.
Autenticación
Authorization: Bearer {jwt} — JWT de Keycloak. El usuario debe ser propietario del contribuyente.
Path parameters
| Parámetro | Tipo | Descripción |
|---|---|---|
contribuyenteId | integer | ID interno del contribuyente |
id | integer | apiKeyId de la clave a eliminar |
Respuesta exitosa
Status: 204 No Content
Sin cuerpo.
La eliminación tiene efecto inmediato. Cualquier integración que use la clave eliminada recibirá 401 Unauthorized en el próximo request.
La operación es permanente — no hay forma de restaurar una clave eliminada. Si solo querés generar un nuevo secreto manteniendo el registro, usá Rotar API Key en su lugar.
Errores
| Status | Tipo | Descripción |
|---|---|---|
| 401 | — | JWT inválido, expirado o ausente |
| 403 | access-denied | El usuario no es propietario del contribuyente |
| 404 | api-key-not-found | El apiKeyId no existe o no pertenece al contribuyente |
Ejemplo
curl -X DELETE \
https://api.sifende.com.py/api/v1/contribuyentes/42/api-keys/42 \
-H "Authorization: Bearer $JWT"