# Özel alan adını kaldırma

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

Bir özel alan adını kaldırır: durumu `released` olur, o alan adında oturum açma durur ve ad 30 gün boyunca karantinada kalır (başka hiçbir ortam bunu ekleyemez). Birincil alan adı ve ortamın veren kuruluşu olarak kullanılan alan adı kaldırılamaz; önce başka bir alan adını birincil yapın. Zaten serbest bırakılmış bir alan adını kaldırmak yalnızca platform kaydındaki serbest bırakmayı tekrarlar.

## İstek

| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| `custom_domain_id` | string | evet | Özel alan adı kimliği (`cdom_…`). |
| `If-Match` | header | evet | Zorunlu. Alan adının `ETag` değeri; eksikse `428`, eşleşmiyorsa `412`. |

İstek gövdesi yok.

## Yanıt

`204 No Content`.

## Hatalar

| HTTP | code | Ne zaman |
|---|---|---|
| 404 | `not_found` | Özel alan adı yok veya başka bir ortama ait. |
| 409 | `custom_domain_in_use` | Alan adı birincil alan adı veya ortamın veren kuruluşu. |
| 409 | `domain_in_use_by_rp_id` | Alan adı bir bağlantının Passkey rpId değeri veya devam eden bir rpId geçişinin önceki rpId değeri; önce rpId değerini [Passkey rpId değerini değiştirin](../connections/change-rp-id.md) ile taşıyın. |
| 412 | `precondition_failed` | `If-Match`, alan adının mevcut sürümüyle eşleşmiyor. |
| 428 | `precondition_required` | `If-Match` eksik. |
| 503 | `service_unavailable` | Platform alan adı kaydı veya ortamın veren kuruluş bilgisi geçici olarak kullanılamıyor. |
| 401 | `unauthenticated` | Kimlik bilgisi eksik, geçersiz veya iptal edilmiş. |
| 403 | `insufficient_permissions` | Kimlik bilgisi gerekli izne sahip değil. |
| 429 | `rate_limited` | Hız sınırı aşıldı; `Retry-After` süresinden sonra tekrar deneyin. |

## Örnek

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