# Revocar el autenticador de un usuario

`DELETE /v1/users/{user_id}/authenticators/{authenticator_id}` · permiso `user-credentials:write`

Revoca un autenticador, incluidas las claves de acceso. `revoked_by` pasa a ser `admin:<actor>` y `revoke_reason` pasa a ser `admin_removed`. Si el autenticador ya está revocado no cambia nada y la llamada devuelve igualmente `204`. Las sesiones del usuario no se cierran. Se notifica al usuario y la acción se registra en el registro de auditoría de gestión.

## Solicitud

| Parámetro | En | Obligatorio | Descripción |
|---|---|---|---|
| `user_id` | path | sí | Identificador del usuario, con el prefijo `usr_`. |
| `authenticator_id` | path | sí | Identificador del autenticador, con el prefijo `cred_`. |

La solicitud no tiene cuerpo.

## Respuesta

`204 No Content`, también cuando el autenticador ya estaba revocado.

## Errores

Cada error es un cuerpo `application/problem+json` con un `code` estable.

| HTTP | `code` | Cuándo |
|---|---|---|
| 404 | `not_found` | El usuario o el autenticador no existe en este entorno, el autenticador no pertenece a este usuario o un identificador tiene un formato incorrecto. |
| 401 | `unauthenticated` | Falta la clave de API, no es válida o ha sido revocada. |
| 403 | `insufficient_permissions` | La clave no tiene el permiso `user-credentials: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/authenticators/cred_0a1b2c3d4e5f6g7h8j9k0m1n2p \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

## Datos personales

Este endpoint contiene datos personales: credenciales. [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.