# Desvincular una identidad

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

Desvincula una identidad social o empresarial de la cuenta del usuario autenticado. No se puede eliminar el último método de inicio de sesión del usuario. Si la organización del usuario aplica SSO en este vínculo, la identidad solo puede eliminarse mediante la API de gestión de clientes. Tras la eliminación correcta, se envía una notificación de seguridad a todas las direcciones de correo electrónico verificadas del usuario. Requiere la cookie `__Host-idp_session` del usuario autenticado; si la cookie falta, ha caducado o ha sido revocada, devuelve `401 unauthenticated`. Una aplicación propia 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)).

La sesión debe haberse verificado en los últimos 5 minutos. Si el usuario tiene un segundo factor, la sesión también debe haberse abierto con un segundo factor (`urn:idp:acr:mfa`).

## Solicitud

Encabezados:

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

`identity_id`: la identidad vinculada en formato `idn_…`.

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 o se requiere un segundo factor; vuelva a verificar con `max_age=300` (y, si corresponde, `acr_values`) en el encabezado `WWW-Authenticate`. |
| 403 | `origin_not_allowed` | `Origin` falta o es incorrecto. |
| 404 | `not_found` | No existe esa identidad para este usuario. |
| 409 | `last_login_method` | Esta identidad es el último método de inicio de sesión del usuario. |
| 409 | `sso_enforced_by_organization` | La organización del usuario aplica SSO en este vínculo. |

## Ejemplo

```bash
curl -X DELETE https://example.keenauth.app/fapi/v1/me/identities/idn_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 contiene datos personales: identidades vinculadas. [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.