v2

latestOpenAPI 3.1.0Proprietary2026-07-26127193620.1 KB
Domains

Verify domain ownership

Checks DNS records required for inbound routing, ownership, and outbound authentication: MX, ownership TXT, SPF, DKIM, DMARC, and TLS-RPT. On success, the domain is promoted from unverified to verified. On failure, returns which checks passed and which failed, plus the exact DNS records still expected. To give users an importable DNS file for missing records, call downloadDomainZoneFile or run primitive domains zone-file --id <domain-id>.

post/domains/{id}/verify

Headers

Idempotency-Keystring

Optional client-supplied idempotency key. Retrying a request with the same key returns the original result instead of performing the action a second time; if omitted the server derives one from the canonical payload hash. Safe to retry network failures without duplicating side effects.

Response

Verification result

successtrue required