Force a DNS check

POST /v1/domains/{id}/check

Re-probes DNS for the hostname right now instead of waiting for the next monitor tick (~60s). Useful immediately after a customer publishes their CNAME, so you can flip your UI from "waiting for DNS" to "live" without polling.

Request

curl -X POST https://api.domainee.dev/v1/domains/$DOMAIN_ID/check \
  -H "Authorization: Bearer $DOMAINEE_API_KEY"

Response — 200 OK

Returns the refreshed Domain object with updated monitorStatus, pointsToEdge, dnsPointedAt, and lastCheckedAt.

{
  "id": "8f09b47c-b42f-4d14-8395-2989db76e6f8",
  "hostname": "shop.acme.com",
  "status": "verified",
  "monitorStatus": "active_ssl",
  "monitorMessage": "Domain is fully active and serving traffic.",
  "isResolving": true,
  "pointsToEdge": true,
  "dnsPointedAt": ["35.165.194.233", "52.39.55.154"],
  "lastCheckedAt": "2026-05-05T13:42:11.000Z"
}

Rate limit

60/min per API key on this endpoint specifically — independently of the global 60/min. See Rate limits.

Errors

Status	Code	When
404	not_found	The id doesn't exist or doesn't belong to your workspace
429	rate_limited	Too many checks; respect Retry-After