
# 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

```bash
curl -X DELETE https://api.eu.keenauth.com/v1/organization-domains/odm_01j9xk3m7q8r2s4t6v8w0y2z4c \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```
