Eine Organisationsdomain löschen
DELETE /v1/organization-domains/{domain_id} · Berechtigung organization-domains:write
Löscht die Domain dauerhaft; ihre Erfassungs- und SSO-Routing-Einstellungen gehen mit ihr verloren. Die Löschung wird in das Verwaltungs-Audit-Log geschrieben und das Ereignis organization_domain.deleted wird veröffentlicht.
Anfrage
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
domain_id |
path | ja | ID der Organisationsdomain (odm_…). |
If-Match |
Header | nein | Optional. Wenn gesendet, muss er mit dem ETag der letzten Lesung übereinstimmen ("<version>"). |
Kein Anfragetext.
Antwort
204 No Content.
Fehler
| HTTP | code | Wann |
|---|---|---|
| 404 | not_found |
In dieser Umgebung existiert keine Organisationsdomain mit dieser ID. |
| 412 | precondition_failed |
If-Match wurde gesendet und stimmt nicht mit der aktuellen Version überein; lesen Sie die Domain erneut. |
| 401 | unauthenticated |
Der Berechtigungsnachweis fehlt, ist ungültig oder widerrufen. |
| 403 | insufficient_permissions |
Dem Berechtigungsnachweis fehlt die erforderliche Berechtigung. |
| 429 | rate_limited |
Das Ratenlimit wurde überschritten; wiederholen Sie nach dem Zeitraum aus Retry-After. |
| 503 | service_unavailable |
Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie nach dem Zeitraum aus Retry-After. |
Beispiel
curl -X DELETE https://api.eu.keenauth.com/v1/organization-domains/odm_01j9xk3m7q8r2s4t6v8w0y2z4c \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"