# 사용자 지정 도메인 삭제

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

사용자 지정 도메인을 삭제합니다. 도메인은 `released` 상태가 되고, 그 도메인으로의 로그인은 중단되며, 이름은 30일 동안 격리됩니다(다른 환경은 이 이름을 추가할 수 없습니다). 기본 도메인과 환경의 발급자로 사용되는 도메인은 삭제할 수 없습니다. 먼저 다른 도메인을 기본 도메인으로 지정하십시오. 이미 해제된 도메인을 삭제하면 플랫폼 레지스트리의 해제 작업만 반복됩니다.

## 요청

| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| `custom_domain_id` | string | 예 | 사용자 지정 도메인 ID(`cdom_…`). |
| `If-Match` | header | 예 | 필수입니다. 도메인의 `ETag`입니다. 없으면 `428`, 일치하지 않으면 `412`를 반환합니다. |

요청 본문은 없습니다.

## 응답

`204 No Content`를 반환합니다.

## 오류

| HTTP | code | 발생 조건 |
|---|---|---|
| 404 | `not_found` | 사용자 지정 도메인이 존재하지 않거나 다른 환경에 속합니다. |
| 409 | `custom_domain_in_use` | 도메인이 기본 도메인이거나 환경의 발급자입니다. |
| 409 | `domain_in_use_by_rp_id` | 도메인이 연결의 패스키 rpId이거나, 진행 중인 rpId 마이그레이션의 이전 rpId입니다. 먼저 [패스키 rpId 변경](../connections/change-rp-id.md)으로 rpId를 옮기십시오. |
| 412 | `precondition_failed` | `If-Match`가 도메인의 현재 버전과 일치하지 않습니다. |
| 428 | `precondition_required` | `If-Match`가 없습니다. |
| 503 | `service_unavailable` | 플랫폼 도메인 레지스트리 또는 환경의 발급자 정보를 일시적으로 사용할 수 없습니다. |
| 401 | `unauthenticated` | 자격 증명이 없거나 잘못되었거나 취소되었습니다. |
| 403 | `insufficient_permissions` | 자격 증명에 필요한 권한이 없습니다. |
| 429 | `rate_limited` | 요청 한도를 초과했습니다. `Retry-After` 기간 이후에 다시 시도하십시오. |

## 예시

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