# 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](list-consents.md)). |

## 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

```bash
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](/docs/policies/personal-data) 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.