Domains

Verify ownership records and diagnose DNS responses for workspace domains.

Endpoints

Check the stored verification record for a workspace domain and mark it verified when the expected DNS record is present. Requires a Pro Plus plan — non-Pro-Plus workspaces receive a 403 (domain verification powers SSO domain enforcement).

10/min per workspace

Scope

domains:write

Parameters

domainIdstringrequiredVerified domain ID from your workspace settings

Response

{
  "verified": true,
  "domain": "example.com",
  "verifiedAt": 1762446710123
}

Run a DNS-over-HTTPS lookup for a domain without mutating any stored verification state.

20/min per IP

Scope

domains:read

Parameters

domainstringrequiredDomain or hostname to inspect

typestringDNS record type: TXT, CNAME, A, or MX (default: TXT)

Response

{
  "domain": "example.com",
  "recordType": "TXT",
  "status": 0,
  "records": [
    {
      "name": "example.com",
      "type": 16,
      "ttl": 300,
      "data": "projectfeed-domain-verification=abc123"
    }
  ]
}

Authentication And Behavior

Both endpoints require a valid API key. Domain verification is scoped to the workspace that owns the stored domain record, while the DNS diagnostic endpoint is authenticated but does not persist any changes.

Verification responses return verified: false with guidance when the expected DNS record is missing or mismatched, so clients can surface actionable setup instructions without retrying blindly.