Mein Konto löschen
POST /fapi/v1/me/deletion · wird vom Anmelde-Host der Umgebung aufgerufen
Plant die Löschung des eigenen Kontos des angemeldeten Benutzers. Das Konto wartet die Zeit self_service_deletion_grace_days der Umgebung ab (0–30 Tage, standardmäßig 14) und wird danach dauerhaft gelöscht. Bei 0 Tagen wird es beim nächsten Lauf des Löschauftrags gelöscht. Alle Sitzungen, Refresh-Tokens und Zugriffstoken des Benutzers werden sofort widerrufen, auch die Sitzung, die die Anfrage gestellt hat. Während der Wartezeit kann sich der Benutzer nur über das Kontoportal anmelden, und zwar nur, um die Löschung abzubrechen oder einen Export der eigenen Daten anzufordern und herunterzuladen.
Erforderlich ist eine aktuelle Anmeldung. Wurde die Sitzung nicht in den letzten 5 Minuten bestätigt oder hat der Benutzer einen zweiten Faktor und die Sitzung hat ihn nicht verwendet, lautet die Antwort 401 step_up_required, und es ändert sich nichts. Wird dieselbe Anfrage erneut gesendet, wird dieselbe ausstehende Löschung zurückgegeben.
Ein Benutzer, der der letzte aktive Administrator einer Organisation ist, kann sein Konto nicht löschen: Die Antwort lautet 409 last_org_admin, und es ändert sich nichts. Zuvor muss einem anderen Mitglied die Administratorrolle der Organisation übertragen werden.
Anfrage
Header:
| Header | Erforderlich | Beschreibung |
|---|---|---|
Idp-Client |
ja | SDK-Kennung. |
Origin |
ja | Muss genau https://<sign-in host> sein. |
Body:
{}
Antwort
202 Accepted:
{"status": "scheduled", "due_at": "2026-11-10T09:30:00Z", "cancellable": true}
Fehler
| Status | Code | Wann |
|---|---|---|
| 401 | unauthenticated |
Kein gültiges Sitzungs-Cookie. |
| 401 | step_up_required |
Anmeldung älter als 5 Minuten oder ein zweiter Faktor ist erforderlich; der Header WWW-Authenticate enthält max_age=300 (und acr_values, wenn ein zweiter Faktor erforderlich ist). |
| 403 | origin_not_allowed |
Origin fehlt oder ist falsch. |
| 403 | user_not_active |
Der Benutzer ist gesperrt oder wird bereits von einem Administrator gelöscht. |
| 404 | not_found |
Die Selbstbedienungslöschung ist in der Umgebung deaktiviert. |
| 409 | last_org_admin |
Der Benutzer ist der letzte aktive Administrator einer Organisation. |
| 503 | service_unavailable |
Das Benutzerverzeichnis ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach Retry-After. |
Beispiel
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
Personenbezogene Daten
Dieser Endpunkt verarbeitet personenbezogene Daten: Profil des Endbenutzers. Personenbezogene Daten in den KeenAuth-APIs beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Senden Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).