# 조직 도메인 지금 검사

`POST /v1/organization-domains/{domain_id}:verify` · 권한 `organization-domains:write`

검증을 즉시 실행합니다. `pending` 또는 `unverified` 도메인은 DNS에서 검사합니다. TXT 레코드가 발견되면 `verified`가 됩니다. 발견되지 않으면 상태는 그대로 유지되고 `last_failure_code`가 설정되며, 응답은 여전히 `200`입니다. `expired` 또는 `revoked` 도메인은 새 토큰(새 TXT 값)과 함께 `pending`으로 돌아갑니다. `verified` 또는 `manual` 도메인은 변경 없이 반환됩니다. 이 배포에서 셀의 DNS 리졸버가 구성되지 않았다면 검사는 `503`으로 거부됩니다.

## 요청

| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| `domain_id` | path | 예 | 조직 도메인 ID(`odm_…`)입니다. |
| `Idempotency-Key` | 헤더 | 아니요 | 요청을 재시도해도 안전하게 만드는 선택 키(16~64자)입니다. |

요청 본문은 없습니다.

## 응답

`200 OK`와 함께 도메인 및 `ETag` 헤더를 반환합니다.

```json
{
  "id": "odm_01j9xk3m7q8r2s4t6v8w0y2z4c",
  "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
  "domain": "acme.com",
  "status": "verified",
  "verification_method": "dns_txt",
  "txt_record_name": "_akp-verify.acme.com",
  "txt_record_value": "idp-verify=EXAMPLEtokenEXAMPLEtokenEXAMPLEtokenEXAMPLEtok",
  "verification_started_at": "2026-10-12T09:30:00.123456Z",
  "verified_at": "2026-10-12T09:35:00.654321Z",
  "last_checked_at": "2026-10-12T09:35:00.654321Z",
  "unverified_at": null,
  "next_check_at": "2026-10-13T09:35:00.654321Z",
  "last_failure_code": null,
  "capture_mode": "off",
  "sso_routing_enabled": false,
  "created_at": "2026-10-12T09:30:00.123456Z",
  "updated_at": "2026-10-12T09:35:00.654321Z",
  "version": 2
}
```

## 오류

| HTTP | code | 발생 조건 |
|---|---|---|
| 404 | `not_found` | 이 환경에 해당 ID의 조직 도메인이 없습니다. |
| 409 | `conflict` | 검사 중 동시 변경이 도메인에 영향을 주었습니다. 다시 시도하세요. |
| 409 | `organization_disabled` | 조직이 비활성화되어 있습니다. |
| 409 | `organization_pending_deletion` | 조직이 셀프 서비스 삭제를 기다리고 있습니다. 먼저 삭제를 취소하세요. |
| 503 | `service_unavailable` | 이 배포에서 DNS 리졸버가 구성되지 않았거나, 종속 서비스를 일시적으로 사용할 수 없습니다. |
| 401 | `unauthenticated` | 자격 증명이 없거나, 잘못되었거나, 폐기되었습니다. |
| 403 | `insufficient_permissions` | 자격 증명에 필요한 권한이 없습니다. |
| 429 | `rate_limited` | 요청 한도를 초과했습니다. `Retry-After` 기간 후에 다시 시도하세요. |

## 예시

```bash
curl -X POST https://api.eu.keenauth.com/v1/organization-domains/odm_01j9xk3m7q8r2s4t6v8w0y2z4c:verify \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```