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