Eliminar una política de una organización

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

Elimina la política; la organización vuelve al valor del entorno para este tipo. La eliminación se escribe en el registro de auditoría de gestión y se publica el evento organization.updated.

Solicitud

Campo Tipo Obligatorio Descripción
org_id path sí ID de la organización (org_…).
policy_kind path sí Tipo de política: authentication_methods, mfa, phishing_resistant, sso_enforcement, session o ip_allowlist. Cualquier otro valor devuelve 404.
If-Match encabezado sí Obligatorio. El ETag de la última lectura ("<version>").

Sin cuerpo de solicitud.

Respuesta

204 No Content.

Errores

HTTP code Cuándo
404 not_found La organización no existe, el tipo es desconocido o no hay escrita ninguna política de este tipo.
412 precondition_failed If-Match no coincide con la versión actual; vuelva a leer la política.
428 precondition_required Falta If-Match.
401 unauthenticated La credencial falta, no es válida o fue revocada.
403 insufficient_permissions La credencial no tiene el permiso requerido.
429 rate_limited Se superó el límite de frecuencia; reintente después del período de Retry-After.
503 service_unavailable Una dependencia no está disponible temporalmente; reintente después del período de Retry-After.

Ejemplo

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