
# Eliminar un autenticador

`DELETE /fapi/v1/me/authenticators/{authenticator_id}` · llamado desde el host de inicio de sesión del entorno

Elimina un registro de autenticador. La eliminación se rechaza si impediría que el usuario inicie sesión en cualquier aplicación del entorno. Tras una eliminación correcta, se envía una notificación de seguridad a las direcciones de correo electrónico verificadas del usuario (según la configuración de notificaciones de seguridad del entorno). Requiere la cookie `__Host-idp_session` del usuario autenticado; si la cookie falta, ha expirado o ha sido revocada, devuelve `401 unauthenticated`. Una aplicación de primera parte en otro origen puede enviar en su lugar su token de acceso a la API frontal (`Authorization: DPoP <token>` con una prueba DPoP; consulte [Token de acceso a la API frontal](/docs/api/fapi/front-api-token)).

## Solicitud

Encabezados:

| Encabezado | Obligatorio | Descripción |
| --- | --- | --- |
| `Idp-Client` | sí | Identificador del SDK. |
| `Origin` | sí | Debe ser exactamente `https://<sign-in host>`. |

Sin cuerpo.

## Respuesta

`204 No Content`.

## Errores

| Estado | Código | Cuándo |
| --- | --- | --- |
| 401 | `unauthenticated` | No hay una cookie de sesión válida. |
| 401 | `step_up_required` | La sesión no se verificó en los últimos 5 minutos; vuelva a verificarla con `max_age=300` en el encabezado `WWW-Authenticate`. |
| 403 | `origin_not_allowed` | Falta `Origin` o es incorrecto. |
| 404 | `not_found` | No existe ese autenticador para este usuario. |
| 409 | `last_factor` | Eliminar este factor impediría que el usuario inicie sesión en al menos una aplicación. |

## Ejemplo

```bash
curl -X DELETE https://example.keenauth.app/fapi/v1/me/authenticators/cred_01j9zzzzzzzzzzzzzzzzzzzzzz \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -b cookies.txt
```

## Datos personales

Este endpoint maneja 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 datos personales de categorías especiales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.
