Vérifier maintenant un domaine d'organisation

POST /v1/organization-domains/{domain_id}:verify · autorisation organization-domains:write

Lance la vérification immédiatement. Un domaine pending ou unverified est contrôlé dans le DNS : si l'enregistrement TXT est trouvé, il passe à verified ; sinon il conserve son statut, last_failure_code est renseigné et la réponse reste 200. Un domaine expired ou revoked repasse à pending avec un nouveau jeton (une nouvelle valeur TXT). Un domaine verified ou manual est renvoyé sans modification. Si le résolveur DNS de la cellule n'est pas configuré dans ce déploiement, la vérification est refusée avec 503.

Requête

Champ Type Obligatoire Description
domain_id path oui Identifiant du domaine d'organisation (odm_…).
Idempotency-Key en-tête non Clé facultative (16 à 64 caractères) qui rend sûre une requête renvoyée.

Aucun corps de requête.

Réponse

200 OK avec le domaine et un en-tête 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
}

Erreurs

HTTP code Quand
404 not_found Aucun domaine d'organisation avec cet identifiant n'existe dans cet environnement.
409 conflict Une modification simultanée a touché le domaine pendant la vérification ; réessayez.
409 organization_disabled L'organisation est désactivée.
409 organization_pending_deletion L'organisation attend une suppression en libre-service ; annulez d'abord la suppression.
503 service_unavailable Le résolveur DNS n'est pas configuré dans ce déploiement, ou une dépendance est temporairement indisponible.
401 unauthenticated L'identifiant est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant ne dispose pas de l'autorisation requise.
429 rate_limited La limite de débit a été dépassée ; réessayez après la période Retry-After.

Exemple

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