# Supprimer une adresse e-mail

`DELETE /fapi/v1/me/emails/{email_id}` · appelé depuis l'hôte de connexion de l'environnement

Supprime l'une des adresses e-mail de l'utilisateur authentifié. L'adresse principale ne peut pas être supprimée ; rendez d'abord une autre adresse vérifiée principale. Si l'environnement exige une adresse e-mail, la dernière adresse vérifiée de l'utilisateur ne peut pas non plus être supprimée. Nécessite le cookie `__Host-idp_session` de l'utilisateur authentifié ; si le cookie est absent, expiré ou révoqué, renvoie `401 unauthenticated`. Une application de premier niveau sur une autre origine peut à la place envoyer son jeton d'accès à l'API front (`Authorization: DPoP <token>` avec une preuve DPoP ; voir [Jeton d'accès à l'API front](/docs/api/fapi/front-api-token)).

La session doit avoir été vérifiée au cours des 5 dernières minutes. Si l'utilisateur dispose d'un second facteur, la session doit aussi avoir été ouverte avec un second facteur (`urn:idp:acr:mfa`).

## Requête

En-têtes :

| En-tête | Obligatoire | Description |
| --- | --- | --- |
| `Idp-Client` | oui | Identifiant du SDK. |
| `Origin` | oui | Doit être exactement `https://<hôte de connexion>`. |

`email_id` : l'identifiant de l'adresse e-mail renvoyé par `GET /fapi/v1/me/emails` (UUID en minuscules).

Pas de corps.

## Réponse

`204 No Content`.

## Erreurs

| Statut | Code | Quand |
| --- | --- | --- |
| 401 | `unauthenticated` | Aucun cookie de session valide. |
| 401 | `step_up_required` | La session n'a pas été vérifiée au cours des 5 dernières minutes ou un second facteur est requis ; vérifiez à nouveau avec `max_age=300` (et, le cas échéant, `acr_values`) dans l'en-tête `WWW-Authenticate`. |
| 403 | `origin_not_allowed` | `Origin` est absent ou incorrect. |
| 404 | `not_found` | Cette adresse e-mail n'existe pas pour cet utilisateur. |
| 409 | `primary_identifier_required` | L'adresse est l'adresse principale. |
| 409 | `last_verified_channel` | L'adresse est la dernière adresse vérifiée de l'utilisateur et l'environnement exige une adresse e-mail. |

## Exemple

```bash
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
```

## Données personnelles

Cet endpoint traite des données personnelles : profil de l'utilisateur final. [Données personnelles dans les API KeenAuth](/docs/policies/personal-data) décrit ce qui est stocké, la durée de conservation et la manière dont elles sont supprimées. Ne transmettez aucune catégorie particulière de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.