Recheck a domain's DNS records

POST https://api.dairo.app/v1/domains/{domain}/verify

Re-checks the DNS records for a pending domain and updates both the domain's status and each record's status to match what is currently published. When all required records resolve, the domain flips to verified, verifiedAt is set, and Dairo emits a domain.verified webhook event — but only on the transition into verified, so re-checking an already-verified domain is a no-op that never re-fires the event. Returns the single updated domain object with its refreshed records. Publish the records described in verify a domain before calling this; DNS can take time to propagate, so a first recheck often still reports pending. Requires domains:write and is rate-limited to 5 rechecks per 15 minutes; the included dairo.app domain always reports verified.

Scope: domains:write. Send the API key as a bearer token; Scopes lists what each one reaches.

Request

curl -X POST "https://api.dairo.app/v1/domains/yourapp.com/verify" \
  -H "Authorization: Bearer $DAIRO_API_KEY"

Path parameters

Response

200 Success. Body: application/json, Domain.

{
  "object": "domain",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "domain": "orin-ai.app",
  "status": "pending",
  "verifiedAt": "2026-10-19T09:30:00Z",
  "region": "eu-north-1",
  "records": [
    {
      "type": "CNAME",
      "host": "string",
      "value": "string",
      "priority": null,
      "status": "pending"
    }
  ],
  "type": "custom",
  "isIncluded": true,
  "isDeletable": true,
  "isSystem": true,
  "isReadOnly": true,
  "receiving": "active"
}

Errors

Every error has the same body, {"error": {"type", "code", "message", "param"}}; branch on code. Errors lists every code.