Skip to main content

Check a proof now

POST 

/v1/domains/:domain_id:verify

202 with the domain (status = pending for a first check; a verified domain stays verified while its re-check runs; check_running = true). Idempotent while that check runs (no second probe); Idempotency-Key replays the first 202. Outcomes: conclusive (verified, or last_error ∈ txt_not_found, file_not_found, file_redirected, meta_not_found, token_mismatch) decide; inconclusive (fetch_error: robots disallow, challenge, 401/403/429/5xx, network) fail a first check but never drop a verified domain (72 h grace). ≤ 30 new checks per organization per clock hour.

Access: API key scope domains:write on a management key; portal users: organization admins and owners; refused with 403 integrations_disabled while domains are switched off for the platform or your organization.

Request​

Responses​

Check started.