Eliminar un dominio de la organización

DELETE /v1/organization-domains/{domain_id} · permiso organization-domains:write

Elimina el dominio de forma permanente; su configuración de captura y de enrutamiento SSO se elimina con él. La eliminación se escribe en el registro de auditoría de gestión y se publica el evento organization_domain.deleted.

Solicitud

Campo Tipo Obligatorio Descripción
domain_id path sí ID del dominio de organización (odm_…).
If-Match encabezado no Opcional. Si se envía, debe coincidir con el ETag de la última lectura ("<version>").

Sin cuerpo de solicitud.

Respuesta

204 No Content.

Errores

HTTP code Cuándo
404 not_found No existe un dominio de organización con este ID en este entorno.
412 precondition_failed Se envió If-Match y no coincide con la versión actual; vuelva a leer el dominio.
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/organization-domains/odm_01j9xk3m7q8r2s4t6v8w0y2z4c \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"