Eine Richtlinie einer Organisation löschen

DELETE /v1/organizations/{org_id}/policies/{policy_kind} · Berechtigung organizations:write

Löscht die Richtlinie; die Organisation kehrt für diese Art zum Wert der Umgebung zurück. Die Löschung wird in das Verwaltungs-Audit-Log geschrieben und das Ereignis organization.updated wird veröffentlicht.

Anfrage

Feld Typ Pflicht Beschreibung
org_id path ja ID der Organisation (org_…).
policy_kind path ja Art der Richtlinie: authentication_methods, mfa, phishing_resistant, sso_enforcement, session oder ip_allowlist. Jeder andere Wert ergibt 404.
If-Match Header ja Erforderlich. Der ETag der letzten Lesung ("<version>").

Kein Anfragetext.

Antwort

204 No Content.

Fehler

HTTP code Wann
404 not_found Die Organisation existiert nicht, die Art ist unbekannt oder es ist keine Richtlinie dieser Art geschrieben.
412 precondition_failed If-Match stimmt nicht mit der aktuellen Version überein; lesen Sie die Richtlinie erneut.
428 precondition_required If-Match fehlt.
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/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/policies/mfa \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "1"'