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