組織のドメインを今すぐチェック
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"