Einen Benutzer löschen
DELETE /v1/users/{user_id} · Berechtigung users:delete
Startet die Löschung eines Benutzers. Der Benutzer wechselt sofort in den Status pending_deletion, und die Löschung ist ab jetzt fällig. Die endgültige Löschung läuft anschließend asynchron. Die Antwort lautet 202 Accepted mit einer deletion_id. Wenn Sie die Anfrage für denselben Benutzer wiederholen, erhalten Sie dieselbe deletion_id. Für diesen Endpunkt gibt es kein Zeitfenster zum Abbrechen.
Anfrage
| Parameter | In | Pflicht | Beschreibung |
|---|---|---|---|
user_id |
Pfad | ja | Benutzer-ID mit dem Präfix usr_. |
Antwort
202 Accepted.
{
"deletion_id": "0191f0a0-0000-8000-8000-000000000001",
"requested_at": "2026-01-15T09:30:00Z"
}
Fehler
Jeder Fehler ist ein application/problem+json-Body mit einem stabilen code.
| HTTP | code |
Wann |
|---|---|---|
| 404 | not_found |
Der Benutzer existiert in dieser Umgebung nicht (oder die ID ist fehlerhaft). |
| 401 | unauthenticated |
Der API-Schlüssel fehlt, ist ungültig oder wurde widerrufen. |
| 403 | insufficient_permissions |
Dem Schlüssel fehlt die Berechtigung users:delete. |
| 429 | rate_limited |
Das Ratenlimit wurde überschritten; beachten Sie Retry-After. |
| 503 | service_unavailable |
Eine Abhängigkeit ist vorübergehend nicht verfügbar; versuchen Sie es später erneut. |
Beispiel
curl -X DELETE https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
Personenbezogene Daten
Dieser Endpunkt verarbeitet personenbezogene Daten: Profil des Endbenutzers. Personenbezogene Daten in den KeenAuth-APIs beschreibt, welche Daten gespeichert werden, wie lange sie aufbewahrt und wie sie gelöscht werden. Senden Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).