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
curl -X POST https://api.usenaive.ai/v1/domains/domain-uuid/verify \
  -H "Authorization: Bearer nv_sk_live_..."
{
  "domain": "mycompany.com",
  "domain_id": "domain-uuid",
  "verified": true,
  "status": "active",
  "dns_status": "provisioned",
  "hint": "Domain verified! You can now create email inboxes on this domain."
}

Unverified Response

If DNS records haven’t propagated yet:
{
  "domain": "mycompany.com",
  "domain_id": "domain-uuid",
  "verified": false,
  "status": "pending_dns",
  "dns_status": "pending_verification",
  "hint": "DNS records not yet verified. Check GET /v1/domains/{id}/dns-records and ensure all records are added."
}

Notes

  • Safe to call multiple times (idempotent)
  • Works for both system domains and custom (BYOD) domains
  • Once verified, the domain status changes to active and inboxes can be created
  • If a system domain is pending_dns after registration, call this to re-check