# Supprimer une adresse e-mail non principale d'un utilisateur

`DELETE /v1/users/{user_id}/emails/{email_id}` · autorisation `users:write`

Supprime une adresse e-mail non principale de l'utilisateur. L'adresse principale ne peut pas être supprimée : rendez d'abord une autre adresse vérifiée principale. Tant que l'environnement exige une adresse e-mail, la dernière adresse vérifiée de l'utilisateur ne peut pas être supprimée. Chaque suppression est consignée dans le journal d'audit de gestion sous `user.email_removed`, avec la clé API comme acteur. Supprimer à nouveau la même ligne renvoie `404` car la ligne n'existe plus : l'effet est idempotent, le code de statut ne l'est pas.

## Requête

| Paramètre | Emplacement | Obligatoire | Description |
|---|---|---|---|
| `user_id` | path | oui | Identifiant de l'utilisateur, préfixé `usr_`. |
| `email_id` | path | oui | Identifiant de la ligne d'adresse e-mail (UUID interne, en minuscules, avec tirets), tel que renvoyé par `GET /v1/users/{user_id}/emails`. |

La requête ne comporte pas de corps.

## Réponse

`204 No Content`.

## Erreurs

Chaque erreur est un corps `application/problem+json` avec un `code` stable.

| HTTP | `code` | Quand |
|---|---|---|
| 409 | `primary_identifier_required` | L'adresse est l'adresse principale. |
| 409 | `last_verified_channel` | L'environnement exige une adresse e-mail et il s'agit de la dernière adresse vérifiée. |
| 404 | `not_found` | L'utilisateur ou la ligne d'adresse e-mail n'existe pas dans cet environnement, l'adresse n'appartient pas à cet utilisateur, ou un identifiant est mal formé. |
| 401 | `unauthenticated` | La clé API est absente, invalide ou révoquée. |
| 403 | `insufficient_permissions` | La clé ne dispose pas de l'autorisation `users:write`. |
| 429 | `rate_limited` | La limite de débit a été dépassée ; respectez `Retry-After`. |
| 503 | `service_unavailable` | Une dépendance est temporairement indisponible ; réessayez plus tard. |

## Exemple

```bash
curl -X DELETE https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/emails/0191f0a0-3333-7444-8555-666666666666 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

## Données personnelles

Cet point de terminaison 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é, pendant combien de temps et comment elles sont supprimées. N'envoyez de catégories particulières de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.