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.

​
id
string
required
Domain UUID
​
recordId
string
required
Provider record ID (from GET /v1/domains/:id/zone-records)
​
acknowledge_unowned
boolean
Pass true (in body or query) to delete a record that wasn’t created by Naive.
curl -X DELETE https://api.usenaive.ai/v1/domains/dom-uuid-2/zone-records/rec_xyz \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "ok": true,
  "domain_id": "dom-uuid-2",
  "record_id": "rec_xyz",
  "mock": false,
  "ownership": "naive"
}

​
Behavior

  1. The record is fetched from the live zone to verify its identity (type and name).
  2. Protected records — DMARC, DKIM, and inbound subdomain MX/TXT — are rejected.
  3. Records not created by Naive are rejected unless acknowledge_unowned=true is passed.
  4. The record is deleted via Vercel; the per-company rate limit (5/min, 20/hr) is charged after the global token budget is reserved, so a 429 from the platform bucket does not consume the tenant’s per-minute slot.

​
Errors

StatuscodereasonCause
403forbiddenSYSTEM_DOMAIN, PROTECTED_RECORDSystem domain or protected record (DMARC/DKIM/inbound)
404resource_not_foundDOMAIN_NOT_FOUND, RECORD_NOT_FOUNDDomain doesn’t exist or record ID isn’t in this zone
409duplicate_recordUNOWNED_RECORD_REQUIRES_ACKRecord was not created by Naive — re-issue with acknowledge_unowned: true
429rate_limitedRATE_LIMITEDPer-company or platform rate limit exceeded. Includes Retry-After header.
501feature_not_configuredFEATURE_DISABLED, MOCK_MODE_REJECTEDFeature flag off or no Vercel credentials
502provider_errorVERCEL_DNS_ERRORVercel returned a non-429 error