Eliminar una dirección de correo electrónico no principal de un usuario
DELETE /v1/users/{user_id}/emails/{email_id} · permiso users:write
Elimina una dirección de correo electrónico no principal del usuario. No se puede eliminar la dirección principal: primero convierta otra dirección verificada en principal. Mientras el entorno requiera una dirección de correo electrónico, no se puede eliminar la última dirección verificada del usuario. Cada eliminación se registra en el registro de auditoría de gestión como user.email_removed, con la clave de API como actor. Eliminar de nuevo la misma fila devuelve 404 porque la fila ya no existe: el efecto es idempotente, pero el código de estado no lo es.
Solicitud
| Parámetro | En | Obligatorio | Descripción |
|---|---|---|---|
user_id |
path | sí | Identificador del usuario, con el prefijo usr_. |
email_id |
path | sí | Identificador de la fila de correo electrónico (UUID interno, en minúsculas y con guiones), tal como lo devuelve GET /v1/users/{user_id}/emails. |
La solicitud no tiene cuerpo.
Respuesta
204 No Content.
Errores
Cada error es un cuerpo application/problem+json con un code estable.
| HTTP | code |
Cuándo |
|---|---|---|
| 409 | primary_identifier_required |
La dirección es la dirección principal. |
| 409 | last_verified_channel |
El entorno requiere una dirección de correo electrónico y esta es la última dirección verificada. |
| 404 | not_found |
El usuario o la fila de correo electrónico no existe en este entorno, el correo electrónico 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 users: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
curl -X DELETE https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/emails/0191f0a0-3333-7444-8555-666666666666 \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
Datos personales
Este endpoint contiene datos personales: perfil del usuario final. Datos personales en las API de KeenAuth 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.