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.

Live zone view, not the verification setup view. This returns every record currently in the Vercel zone (with the provider record IDs needed for delete). For the read-only list of Resend email setup records the customer needs to add to pass verification, see /dns-records.
​
id
string
required
Domain UUID
curl https://api.usenaive.ai/v1/domains/dom-uuid-2/zone-records \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "domain": "acme.com",
  "domain_id": "dom-uuid-2",
  "mock": false,
  "records": [
    {
      "id": "rec_abc",
      "type": "A",
      "name": "",
      "value": "76.76.21.21",
      "ttl": 60,
      "comment": "naive:owned;company=co_...;agent=ag_...;ts=1717..."
    },
    {
      "id": "rec_def",
      "type": "CNAME",
      "name": "www",
      "value": "shops.myshopify.com",
      "ttl": 60
    }
  ]
}

​
Differences from GET /v1/domains/:id/dns-records

EndpointReturns
GET /v1/domains/:id/dns-recordsThe Resend setup records (MX, TXT for SPF, CNAME for DKIM) the customer must add at their registrar to pass verification. Read-only and informational.
GET /v1/domains/:id/zone-recordsEvery record currently in the live Vercel zone, with the provider record ID (id) needed for DELETE /v1/domains/:id/zone-records/:recordId.

​
Fields

FieldDescription
domainThe fully-qualified domain
domain_idDomain UUID
mocktrue when running in DOMAIN_MOCK mode (no real Vercel call)
records[].idProvider record ID — pass to DELETE for removal
records[].typeA, AAAA, CNAME, MX, TXT, NS, or CAA
records[].nameRecord name; "" for apex
records[].valueRecord value
records[].ttlTTL in seconds
records[].priorityMX priority (MX records only)
records[].commentVercel record comment; records written by Naive use naive:owned;company=...;agent=...;ts=...

​
Errors

StatusreasonCause
501FEATURE_DISABLEDAGENT_DNS_EDIT_ENABLED is false on the API
501MOCK_MODE_REJECTEDNo VERCEL_REGISTRAR_TOKEN and DOMAIN_MOCK not enabled
403SYSTEM_DOMAINTried to read a system-registered domain (system domains are read-only via this endpoint)
404DOMAIN_NOT_FOUNDDomain doesn’t exist or belongs to another company