Eliminare un dominio dell'organizzazione
DELETE /v1/organization-domains/{domain_id} · autorizzazione organization-domains:write
Elimina il dominio in modo permanente; con esso vanno perse anche le impostazioni di cattura e di instradamento SSO. L'eliminazione viene scritta nel log di audit di gestione e viene pubblicato l'evento organization_domain.deleted.
Richiesta
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
domain_id |
path | sì | ID del dominio dell'organizzazione (odm_…). |
If-Match |
header | no | Facoltativo. Se inviato deve corrispondere all'ETag dell'ultima lettura ("<version>"). |
Nessun corpo della richiesta.
Risposta
204 No Content.
Errori
| HTTP | code | Quando |
|---|---|---|
| 404 | not_found |
In questo ambiente non esiste un dominio di organizzazione con questo ID. |
| 412 | precondition_failed |
È stato inviato If-Match ma non corrisponde alla versione corrente; rileggere il dominio. |
| 401 | unauthenticated |
La credenziale manca, non è valida o è stata revocata. |
| 403 | insufficient_permissions |
La credenziale non ha l'autorizzazione richiesta. |
| 429 | rate_limited |
È stato superato il limite di frequenza; riprovare dopo il periodo indicato in Retry-After. |
| 503 | service_unavailable |
Una dipendenza è temporaneamente non disponibile; riprovare dopo il periodo indicato in Retry-After. |
Esempio
curl -X DELETE https://api.eu.keenauth.com/v1/organization-domains/odm_01j9xk3m7q8r2s4t6v8w0y2z4c \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"