Organisation löschen
DELETE /v1/organizations/{org_id} · Berechtigung organizations:write
Löscht eine Organisation sofort und endgültig; es gibt keine Wartezeit und keine Rücknahme. Der Slug bleibt 90 Tage reserviert. Ein organization.deleted-Ereignis wird veröffentlicht und die Löschung ins Management-Audit-Log geschrieben.
Anfrage
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
org_id |
path | ja | ID der Organisation (org_…). |
Kein Request-Body.
Antwort
204 No Content.
Fehler
| HTTP | Code | Wann |
|---|---|---|
| 404 | not_found |
In dieser Umgebung gibt es keine Organisation mit dieser ID. |
| 401 | unauthenticated |
Die Anmeldedaten fehlen, sind ungültig oder widerrufen. |
| 403 | insufficient_permissions |
Den Anmeldedaten fehlt die erforderliche Berechtigung. |
| 429 | rate_limited |
Das Ratenlimit wurde überschritten; nach der Retry-After-Zeit erneut versuchen. |
| 503 | service_unavailable |
Eine Abhängigkeit ist vorübergehend nicht verfügbar; nach der Retry-After-Zeit erneut versuchen. |
Beispiel
curl -X DELETE "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"