---
title: "DNS API"
description: "Manage DNS zones, records, zone backups and development domains over the Edge REST API, with endpoint reference tables and curl examples."
url: "https://edge.network/docs/api/dns"
section: "REST API"
---

# DNS API

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

All endpoints require [authentication](/docs/api/authentication).

## Quick start

```bash
# 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](/docs/dns/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](/docs/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](/docs/dns/geo-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](/docs/dns/backups) on or off |

## Development domains

[test.network](/docs/dns/test-domains) and [ed.ge](/docs/dns/edge-domains) 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 |