Skip to main content

Documentation Index

Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

This is not the live zone view. This endpoint returns only the Resend email-provider setup records (MX/TXT/CNAME) that the customer needs to add at their registrar to pass email-domain verification. To see (or modify) every record currently on the live Vercel zone, use the /zone-records endpoints instead.
id
string
required
Domain UUID
curl https://api.usenaive.ai/v1/domains/domain-uuid/dns-records \
  -H "Authorization: Bearer nv_sk_live_..."
{
  "domain": "mycompany.com",
  "domain_id": "domain-uuid",
  "status": "pending_dns",
  "dns_status": "pending_verification",
  "records": [
    { "type": "MX", "name": "mycompany.com", "value": "feedback-smtp.us-east-1.amazonses.com", "priority": 10, "status": "verified" },
    { "type": "TXT", "name": "mycompany.com", "value": "v=spf1 include:amazonses.com ~all", "status": "pending" },
    { "type": "CNAME", "name": "resend._domainkey.mycompany.com", "value": "resend.domainkey.example.com", "status": "pending" }
  ]
}

Record Statuses

StatusMeaning
verifiedRecord confirmed in DNS
pendingRecord not yet detected

Notes

  • All records must be verified before the domain becomes active
  • Use this endpoint to check which records still need to be added
  • DNS propagation typically takes 5–60 minutes after adding records

Compared to /zone-records

EndpointReturnsMutable?
GET /v1/domains/:id/dns-records (this)Just the Resend email setup records (MX/TXT/CNAME) needed to pass verificationNo
GET /v1/domains/:id/zone-recordsEvery record currently on the live Vercel zone, with provider record IDsYes (via POST/DELETE)
The MCP tool for this endpoint is naive_resend_setup_records. The MCP tools for the live zone are naive_list_dns_records, naive_set_dns_record, and naive_delete_dns_record.