# 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:

```json
{}
```

## Antwort

`202 Accepted`:

```json
{"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

```bash
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](/docs/policies/personal-data) 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).