조직 도메인 영구 삭제
DELETE /v1/organization-domains/{domain_id} · 권한 organization-domains:write
도메인을 영구적으로 삭제합니다. 도메인의 캡처 및 SSO 라우팅 설정도 함께 삭제됩니다. 삭제 내용은 관리 감사 로그에 기록되고 organization_domain.deleted 이벤트가 게시됩니다.
요청
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
domain_id |
path | 예 | 조직 도메인 ID(odm_…)입니다. |
If-Match |
헤더 | 아니요 | 선택 사항입니다. 보내는 경우 마지막으로 읽은 ETag("<version>")와 일치해야 합니다. |
요청 본문은 없습니다.
응답
204 No Content.
오류
| HTTP | code | 발생 조건 |
|---|---|---|
| 404 | not_found |
이 환경에 해당 ID의 조직 도메인이 없습니다. |
| 412 | precondition_failed |
If-Match를 보냈지만 현재 버전과 일치하지 않습니다. 도메인을 다시 읽으세요. |
| 401 | unauthenticated |
자격 증명이 없거나, 잘못되었거나, 폐기되었습니다. |
| 403 | insufficient_permissions |
자격 증명에 필요한 권한이 없습니다. |
| 429 | rate_limited |
요청 한도를 초과했습니다. Retry-After 기간 후에 다시 시도하세요. |
| 503 | service_unavailable |
종속 서비스를 일시적으로 사용할 수 없습니다. Retry-After 기간 후에 다시 시도하세요. |
예시
curl -X DELETE https://api.eu.keenauth.com/v1/organization-domains/odm_01j9xk3m7q8r2s4t6v8w0y2z4c \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"