# Desvincular una identidad vinculada de un usuario

`DELETE /v1/users/{user_id}/identities/{identity_id}` · permiso `users:write`

Elimina una identidad vinculada de un usuario (contraseña, social, SAML, OIDC o heredada). La eliminación se realiza aunque una organización a la que pertenezca el usuario exija Single Sign-On mediante la conexión de la identidad: el usuario no puede eliminar esa identidad desde el portal de la cuenta (`409 sso_enforced_by_organization`), y el cliente la elimina con este endpoint. El último método de primer factor del usuario no puede eliminarse (`409 last_login_method`). Se notifica al usuario en cada dirección de correo electrónico verificada, y la acción se registra en el registro de auditoría de gestión con la clave de API como actor.

## Solicitud

| Parámetro | En | Obligatorio | Descripción |
|---|---|---|---|
| `user_id` | path | sí | Id del usuario, con el prefijo `usr_`. |
| `identity_id` | path | sí | Id de la identidad, con el prefijo `idn_` (tal como lo devuelve `GET /v1/users/{user_id}/identities`). |

La solicitud no lleva cuerpo.

## Respuesta

`204 No Content`.

## Errores

Todos los errores son un cuerpo `application/problem+json` con un `code` estable.

| HTTP | `code` | Cuándo |
|---|---|---|
| 404 | `not_found` | El usuario no existe en este entorno, la identidad no pertenece a este usuario o es desconocida, o algún id tiene un formato incorrecto. |
| 409 | `last_login_method` | Esta identidad es el último método de primer factor del usuario; añada primero otro método. |
| 401 | `unauthenticated` | La clave de API falta, no es válida o ha sido revocada. |
| 403 | `insufficient_permissions` | La clave no tiene el permiso `users:write`. |
| 429 | `rate_limited` | Se superó el límite de frecuencia; respete `Retry-After`. |
| 503 | `service_unavailable` | Una dependencia no está disponible temporalmente; reintente más tarde. |

## Ejemplo

```bash
curl -X DELETE https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/identities/idn_0a1b2c3d4e5f6g7h8j9k0m1n2r \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

## Datos personales

Este endpoint trata datos personales: identidades vinculadas. [Datos personales en las API de KeenAuth](/docs/policies/personal-data) describe qué se almacena, 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.