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
- 202
- 403
- 404
- 422
- 429
Check started.
scope_missing (details.required_scope), role_insufficient, kb_not_in_allowlist, integrations_disabled (details.area, details.scope), domain_blocked.
not_found — identical for missing resources and resources of another organization (details.resource).
validation_failed, webhook_url_rejected (details.rule), event_type_unknown, domain_invalid, method_not_allowed_for_domain.
rate_limited, webhook_test_rate_limited, verification_rate_limited (with Retry-After and retry_after_seconds).