Check domain DNS
POST/api/domains/:id/verify
x-audience: "management"
x-required-scope: "domains:write"
No body. Checks ownership TXT and MX separately with an eight-second DNS timeout. A 200 response may have observed.ownership or observed.mx false. domain.ready reports domain catch-all readiness. With no catch-all, a verified domain with valid MX can still accept matching active exact-address routes with active endpoints.
Request
Responses
- 200
- 401
- 403
- 404
- 429
- 503
Success
Missing, invalid or revoked credentials.
Required scope or account access missing.
Domain not found.
Shared client-IP or account request allowance exhausted. Retry after the indicated number of seconds. Browser authentication errors can use a different response format.
Response Headers
no-store
Seconds to wait before retrying.
DNS lookup unavailable or timed out. Shared request limiting can also return 503 rate_limit_unavailable with Cache-Control: no-store.
Response Headers
Request limiter responses use no-store.