# Rimuovi un dominio personalizzato

`DELETE /v1/custom-domains/{custom_domain_id}` · autorizzazione `custom-domains:write`

Rimuove un dominio personalizzato: passa a `released`, l'accesso tramite esso si interrompe e il nome resta in quarantena per 30 giorni (nessun altro ambiente può aggiungerlo). Il dominio principale e il dominio usato come issuer dell'ambiente non possono essere rimossi; rendi prima primario un altro dominio. Rimuovere un dominio già rilasciato ripete solo il rilascio nel registro della piattaforma.

## Richiesta

| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `custom_domain_id` | string | sì | ID del dominio personalizzato (`cdom_…`). |
| `If-Match` | header | sì | Obbligatorio. Il `ETag` del dominio; `428` se manca, `412` se non corrisponde. |

Nessun corpo della richiesta.

## Risposta

`204 No Content`.

## Errori

| HTTP | code | Quando |
|---|---|---|
| 404 | `not_found` | Il dominio personalizzato non esiste o appartiene a un altro ambiente. |
| 409 | `custom_domain_in_use` | Il dominio è il dominio principale o l'issuer dell'ambiente. |
| 409 | `domain_in_use_by_rp_id` | Il dominio è il rpId di una passkey di una connessione, oppure il rpId precedente di una migrazione di rpId in corso; sposta prima il rpId con [Cambia il rpId della passkey](../connections/change-rp-id.md). |
| 412 | `precondition_failed` | `If-Match` non corrisponde alla versione corrente del dominio. |
| 428 | `precondition_required` | `If-Match` manca. |
| 503 | `service_unavailable` | Il registro dei domini della piattaforma o le informazioni sull'issuer dell'ambiente non sono temporaneamente disponibili. |
| 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 richieste; riprova dopo il periodo indicato in `Retry-After`. |

## Esempio

```bash
curl -X DELETE https://api.eu.keenauth.com/v1/custom-domains/cdom_01j9xk3m7q8r2s4t6v8w0y2z4a \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "3"'
```