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"