Eliminare una policy di un'organizzazione

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

Elimina la policy; l'organizzazione torna al valore dell'ambiente per questo tipo. L'eliminazione viene scritta nel log di audit di gestione e viene pubblicato l'evento organization.updated.

Richiesta

Campo Tipo Obbligatorio Descrizione
org_id path sì ID dell'organizzazione (org_…).
policy_kind path sì Tipo di policy: authentication_methods, mfa, phishing_resistant, sso_enforcement, session oppure ip_allowlist. Qualsiasi altro valore restituisce 404.
If-Match header sì Obbligatorio. L'ETag dell'ultima lettura ("<version>").

Nessun corpo della richiesta.

Risposta

204 No Content.

Errori

HTTP code Quando
404 not_found L'organizzazione non esiste, il tipo è sconosciuto, oppure non è scritta alcuna policy di questo tipo.
412 precondition_failed If-Match non corrisponde alla versione corrente; rileggere la policy.
428 precondition_required If-Match manca.
401 unauthenticated La credenziale manca, non è valida o è stata revocata.
403 insufficient_permissions La credenziale non ha l'autorizzazione richiesta.
429 rate_limited È stato superato il limite di frequenza; riprovare dopo il periodo indicato in Retry-After.
503 service_unavailable Una dipendenza è temporaneamente non disponibile; riprovare dopo il periodo indicato in Retry-After.

Esempio

curl -X DELETE https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/policies/mfa \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "1"'