Eliminar una dirección de correo electrónico
DELETE /fapi/v1/me/emails/{email_id} · llamado desde el host de inicio de sesión del entorno
Elimina una de las direcciones de correo electrónico del usuario autenticado. No se puede eliminar la dirección principal; primero haga que otra dirección verificada sea la principal. Si el entorno requiere una dirección de correo electrónico, tampoco se puede eliminar la última dirección verificada del usuario. 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 origen propio 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).
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>. |
email_id: el identificador de la dirección de correo electrónico devuelto por GET /fapi/v1/me/emails (UUID en minúsculas).
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 esta dirección de correo electrónico para este usuario. |
| 409 | primary_identifier_required |
La dirección es la principal. |
| 409 | last_verified_channel |
La dirección es la última verificada del usuario y el entorno requiere una dirección de correo electrónico. |
Ejemplo
curl -X DELETE https://example.keenauth.app/fapi/v1/me/emails/0190a5c4-1b2c-7d3e-8f40-516273849abc \
-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: perfil del usuario final. 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.