DNS API

Manage zones, records, backups, and development domains under /api/dns.

On this page5 sections

All endpoints require authentication.

Quick start#

Terminal

# Create a zone
curl -X POST https://edge.network/api/dns/zones \
  -H "Authorization: Bearer ek_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "domain": "example.com" }'

# Add an A record
curl -X POST https://edge.network/api/dns/zones/ZONE_ID/records \
  -H "Authorization: Bearer ek_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "A",
    "name": "www",
    "data": "203.0.113.10",
    "ttl": 3600
  }'

After creating a zone, point your domain at the Edge nameservers and call POST /api/dns/zones/:id/verify to confirm delegation.

Zones#

Endpoint	Description
`GET /api/dns/zones`	List zones
`POST /api/dns/zones`	Create. Body: `{ "domain": "example.com" }`. Returns 201.
`GET /api/dns/zones/:id`	Get a zone
`DELETE /api/dns/zones/:id`	Delete a zone and its records
`POST /api/dns/zones/:id/verify`	Check nameserver delegation. Returns `{ verified, currentNs }`
`GET /api/dns/zones/:id/metrics?range=24h`	Query metrics. `range` is `1h`, `24h`, `7d` or `30d`
`GET /api/dns/zones/:id/events`	Zone activity log
`GET \| POST /api/dns/zones/:id/examine`	Fetch / run the DNS Examiner AI analysis
`GET /api/dns/usage`	Zone count and per-zone query usage against limits

Records#

Endpoint	Description
`GET /api/dns/zones/:id/records`	List records in a zone
`POST /api/dns/zones/:id/records`	Add a record. Body: `{ type, name, data, ttl?, priority?, geo? }` (`priority` required for MX)
`PUT /api/dns/zones/:id/records/:recordId`	Update any of the same fields
`DELETE /api/dns/zones/:id/records/:recordId`	Delete a record

Supported types: A, AAAA, CNAME, MX, TXT, NS, ALIAS, CAA, PTR, SRV. The geo field enables geographic routing.

Zone backups#

Endpoint	Description
`GET \| POST /api/dns/zones/:id/backups`	List backups / take a manual backup
`GET /api/dns/zones/:id/backups/:backupId`	Download a backup
`POST /api/dns/zones/:id/backups/:backupId/restore`	Restore. Takes a safety backup first unless `createPreBackup: false`
`DELETE /api/dns/zones/:id/backups/:backupId`	Delete a backup
`POST /api/dns/zones/:id/backups/enable \| disable`	Turn automatic zone backups on or off

Development domains#

test.network and ed.ge subdomains can be purchased and managed through the API:

Endpoint	Description
`GET /api/dns/test-domains \| edge-domains`	List your domains
`GET .../check/:subdomain`	Check availability
`POST /api/dns/test-domains \| edge-domains`	Purchase. Body: `{ "subdomain": "myapp" }` (card on file required)
`DELETE .../:id`	Release a domain

Something unclear or out of date? Tell us

View as Markdown Get support