Supprimer un utilisateur
DELETE /v1/users/{user_id} · autorisation users:delete
Lance la suppression d'un utilisateur. L'utilisateur passe immédiatement à pending_deletion et la suppression est due dès maintenant ; la suppression définitive s'exécute ensuite de manière asynchrone. La réponse est 202 Accepted avec un deletion_id. Répéter la requête pour le même utilisateur renvoie le même deletion_id. Ce point de terminaison ne prévoit aucune fenêtre d'annulation.
Requête
| Paramètre | Dans | Obligatoire | Description |
|---|---|---|---|
user_id |
path | oui | Identifiant de l'utilisateur, préfixé usr_. |
Réponse
202 Accepted.
{
"deletion_id": "0191f0a0-0000-8000-8000-000000000001",
"requested_at": "2026-01-15T09:30:00Z"
}
Erreurs
Chaque erreur est un corps application/problem+json avec un code stable.
| HTTP | code |
Quand |
|---|---|---|
| 404 | not_found |
L'utilisateur n'existe pas dans cet environnement (ou l'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:delete. |
| 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 \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
Données personnelles
Ce 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é, la durée de conservation et la manière dont 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.