Domains
Domain registration, DNS, WHOIS profiles, and lifecycle sync.
Domains covers registrar purchase, DNS records, pricing checks, transfer-in, transfer-out, and importing domains you already own at an external registrar (GoDaddy, Namecheap, or Brandsight).
Domain registration, DNS writes, refresh, verification, settings updates, transfer-in, and transfer-out require an owner/admin browser session with fresh step-up. API keys are rejected with 403 "Domain administration requires a browser session".
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/v1/domains | List domains; lifecycle sync runs in the background (lifecycleSync.status: "background"). |
POST | /api/v1/domains | Register a domain. |
GET | /api/v1/domains/check | Availability check. |
GET | /api/v1/domains/suggestions | Name suggestions. |
GET | /api/v1/domains/prices | TLD pricing. |
GET | /api/v1/domains/:id | Domain details. |
PATCH | /api/v1/domains/:id | Update settings. |
GET | /api/v1/domains/:id/dns | DNS records. |
POST | /api/v1/domains/:id/dns | Create a DNS record; requires browser session + step-up. |
PUT | /api/v1/domains/:id/dns | Update a DNS record (recordId in body); requires browser session + step-up. |
DELETE | /api/v1/domains/:id/dns?recordId= | Delete a DNS record; requires browser session + step-up. |
POST | /api/v1/domains/transfer-in | Start transfer in with a domain authorization code; requires browser session + step-up. |
GET | /api/v1/domains/:id/transfer-in | Refresh and read transfer-in status. |
POST | /api/v1/domains/:id/refresh | Refresh registrar status. |
POST | /api/v1/domains/:id/verify | Verify ownership. |
POST | /api/v1/domains/:id/transfer-out | Start transfer out. |
GET | /api/v1/domains/providers | List external registrar providers with connector connections and imported domain counts. |
POST | /api/v1/domains/providers/import | Import domains from a connected registrar (provider, optional connectionId, optional domains list of up to 200 names, syncDns defaults to true); requires browser session + step-up. |
POST | /api/v1/domains/:id/registrar-sync | Sync DNS records from the external registrar for an imported domain; requires browser session + step-up. |
WHOIS contact profiles live under GET/POST/PATCH/DELETE /api/v1/whois-profiles.