Revocar el consentimiento de un usuario
DELETE /v1/users/{user_id}/consents/{consent_id} · permiso users:write
Revoca un consentimiento de OAuth que el usuario concedió a una aplicación. Se revocan las familias de tokens de actualización del usuario para esa aplicación, los tokens de acceso emitidos antes de la llamada dejan de aceptarse en la introspección y en la comprobación de revocación, y la siguiente solicitud de autorización de la aplicación vuelve a pedir el consentimiento al usuario. Las sesiones del usuario y las demás aplicaciones no se ven afectadas. La revocación se registra en el registro de auditoría de gestión como consent.revoked.
Revocar un consentimiento que ya está revocado devuelve 404.
Solicitud
| Parámetro | En | Obligatorio | Descripción |
|---|---|---|---|
user_id |
path | sí | Identificador del usuario, con el prefijo usr_. |
consent_id |
path | sí | Identificador del consentimiento, con el prefijo cns_ (de Listar los consentimientos de un usuario). |
Respuesta
204 No Content.
Errores
Cada error es un cuerpo application/problem+json con un code estable.
| HTTP | code |
Cuándo |
|---|---|---|
| 404 | not_found |
El usuario no existe en este entorno, o el consentimiento no existe, pertenece a otro usuario o ya está revocado. |
| 401 | unauthenticated |
Falta la clave de API, no es válida o ha sido revocada. |
| 403 | insufficient_permissions |
La clave no tiene el permiso users:write. |
| 429 | rate_limited |
Se ha superado el límite de frecuencia; respete Retry-After. |
| 503 | service_unavailable |
Una dependencia no está disponible temporalmente; vuelva a intentarlo más tarde. |
Ejemplo
curl -X DELETE https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/consents/cns_01jb2k8m5c3f6t9w2y4b7d0g3k \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
CLI: keenauth users consents delete usr_0a1b2c3d4e5f6g7h8j9k0m1n2p cns_01jb2k8m5c3f6t9w2y4b7d0g3k --yes
Datos personales
Este endpoint contiene datos personales: registros de consentimiento. Datos personales en las API de KeenAuth describe qué se almacena, durante cuánto tiempo se conserva y cómo se elimina. No envíe categorías especiales de datos personales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.