Supprimer mon compte
POST /fapi/v1/me/deletion · appelé depuis l'hôte de connexion de l'environnement
Planifie la suppression du compte de l'utilisateur connecté. Le compte attend le nombre de jours défini par self_service_deletion_grace_days de l'environnement (de 0 à 30 jours, 14 par défaut), puis il est supprimé définitivement ; avec 0 jour, il est supprimé à la prochaine exécution de la tâche de suppression. Toutes les sessions, tous les jetons d'actualisation et tous les jetons d'accès de l'utilisateur sont révoqués immédiatement, y compris la session qui a fait la demande. Pendant le délai d'attente, l'utilisateur ne peut se connecter que via le portail du compte, et uniquement pour annuler la suppression ou pour demander et télécharger un export de ses propres données.
Nécessite une connexion récente : si la session n'a pas été vérifiée au cours des 5 dernières minutes, ou si l'utilisateur possède un second facteur que la session n'a pas utilisé, la réponse est 401 step_up_required et rien ne change. Renvoyer la même requête retourne la même suppression en attente.
Un utilisateur qui est le dernier administrateur actif d'une organisation ne peut pas supprimer son compte : la réponse est 409 last_org_admin et rien ne change. Un autre membre doit d'abord recevoir le rôle d'administrateur de l'organisation.
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>. |
Corps :
{}
Réponse
202 Accepted :
{"status": "scheduled", "due_at": "2026-11-10T09:30:00Z", "cancellable": true}
Erreurs
| Statut | Code | Quand |
|---|---|---|
| 401 | unauthenticated |
Aucun cookie de session valide. |
| 401 | step_up_required |
Connexion datant de plus de 5 minutes, ou second facteur requis ; l'en-tête WWW-Authenticate contient max_age=300 (et acr_values lorsqu'un second facteur est requis). |
| 403 | origin_not_allowed |
Origin est absent ou incorrect. |
| 403 | user_not_active |
L'utilisateur est bloqué ou fait déjà l'objet d'une suppression par un administrateur. |
| 404 | not_found |
La suppression de compte en libre-service est désactivée dans l'environnement. |
| 409 | last_org_admin |
L'utilisateur est le dernier administrateur actif d'une organisation. |
| 503 | service_unavailable |
L'annuaire des utilisateurs est temporairement indisponible ; réessayez après Retry-After. |
Exemple
curl -X POST https://example.keenauth.app/fapi/v1/me/deletion \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-H "Content-Type: application/json" \
-d '{}' \
-b cookies.txt
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é, pendant combien de temps et comment elles sont supprimées. N'envoyez aucune catégorie particulière de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.