DNS API
Manage zones, records, backups, and development domains under
/api/dns.
All endpoints require authentication.
Quick Start
# 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 — { 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 |