Supprimer une politique d'organisation

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

Supprime la politique ; l'organisation revient à la valeur de l'environnement pour ce type. La suppression est écrite dans le journal d'audit de gestion et l'événement organization.updated est publié.

Requête

Champ Type Obligatoire Description
org_id path oui Identifiant de l'organisation (org_…).
policy_kind path oui Type de politique : authentication_methods, mfa, phishing_resistant, sso_enforcement, session ou ip_allowlist. Toute autre valeur renvoie 404.
If-Match en-tête oui Requis. L'ETag de la dernière lecture ("<version>").

Aucun corps de requête.

Réponse

204 No Content.

Erreurs

HTTP code Quand
404 not_found L'organisation n'existe pas, le type est inconnu, ou aucune politique de ce type n'est écrite.
412 precondition_failed If-Match ne correspond pas à la version actuelle ; relisez la politique.
428 precondition_required If-Match est absent.
401 unauthenticated L'identifiant est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant ne dispose pas de l'autorisation requise.
429 rate_limited La limite de débit a été dépassée ; réessayez après la période Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez après la période Retry-After.

Exemple

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