조직 도메인 지금 검사

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 헤더를 반환합니다.

{
  "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 기간 후에 다시 시도하세요.

예시

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