Supprimer un domaine d'organisation
DELETE /v1/organization-domains/{domain_id} · autorisation organization-domains:write
Supprime définitivement le domaine ; ses paramètres de capture et de routage SSO disparaissent avec lui. La suppression est écrite dans le journal d'audit de gestion et l'événement organization_domain.deleted est publié.
Requête
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
domain_id |
path | oui | Identifiant du domaine d'organisation (odm_…). |
If-Match |
en-tête | non | Facultatif. Lorsqu'il est envoyé, il doit correspondre à 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 |
Aucun domaine d'organisation avec cet identifiant n'existe dans cet environnement. |
| 412 | precondition_failed |
If-Match a été envoyé et ne correspond pas à la version actuelle ; relisez le domaine. |
| 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/organization-domains/odm_01j9xk3m7q8r2s4t6v8w0y2z4c \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"