Status der Kontolöschung abrufen

GET /fapi/v1/me/deletion · wird vom Anmelde-Host der Umgebung aufgerufen

Gibt die eigene ausstehende Kontolöschung des angemeldeten Benutzers zurück, sofern eine vorliegt. status ist none, wenn das Konto nicht gelöscht wird, und scheduled während der Wartezeit. Dann gibt due_at an, wann die Löschung endgültig wird, und cancellable zeigt, ob DELETE /fapi/v1/me/deletion sie noch abbrechen kann. Erforderlich ist das Cookie __Host-idp_session des authentifizierten Benutzers. Eine First-Party-Anwendung auf einem anderen Origin kann stattdessen ihr Front-API-Zugriffstoken senden (Authorization: DPoP <token> mit einem DPoP-Proof; siehe Front-API-Zugriffstoken). Zum Lesen ist keine aktuelle Anmeldung erforderlich.

Während ein Konto auf die Löschung wartet, kann seine Sitzung unter den /fapi/v1/me-Endpunkten nur diese Ressource und die eigenen Datenexporte des Benutzers (/fapi/v1/me/exports) erreichen. Die übrigen Endpunkte antworten mit 403 user_not_active.

Anfrage

Header:

Header Erforderlich Beschreibung
Idp-Client ja SDK-Kennung.

Antwort

200 OK:

{"status": "scheduled", "due_at": "2026-11-10T09:30:00Z", "cancellable": true}
{"status": "none", "cancellable": false}

Fehler

Status Code Wann
401 unauthenticated Kein gültiges Sitzungs-Cookie.
404 not_found Der Benutzer wurde nicht gefunden.
503 service_unavailable Das Benutzerverzeichnis ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach Retry-After.

Beispiel

curl https://example.keenauth.app/fapi/v1/me/deletion \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -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).