DNS
DNS backups
Automated daily snapshots of your DNS zones. Download them as JSON, restore in one click, and never lose a DNS configuration again.
On this page6 sections
How it works#
- Open a DNS zone and navigate to the Backups tab.
- Click Enable ($1/mo) to activate daily backups for the zone.
- Automated backups run daily at 02:00 UTC. You can also create manual backups at any time.
Backup types#
- Auto: created automatically at 02:00 UTC daily. Subject to the retention policy.
- Manual: created on demand via the Create Backup button. Useful before making major changes.
- Pre-restore: created automatically before a restore operation, so you can always undo a restore.
Retention#
Automated backups expire after 30 days. Manual and pre-restore backups do not expire automatically.
| Plan | Retention |
|---|---|
| Hobbyist | 7 days |
| Dev | 7 days |
| Startup | 30 days |
| Scaleup / Business | 30 days |
| Enterprise | 90 days |
Restoring from a backup#
- Go to the Backups tab on the zone.
- Click the restore icon on the backup you want to restore.
- Confirm the restore. A safety backup of the current state is created automatically.
- All records are replaced with those from the backup.
- Changes are pushed to the DNS network immediately.
Downloading backups#
Click the download icon on any backup to save it as a JSON file. The file contains all DNS records for the zone at that point in time.
API#
| Method | Endpoint | Description |
|---|---|---|
GET |
/api/dns/zones/:id/backups |
List backups for a zone |
POST |
/api/dns/zones/:id/backups |
Create a manual backup |
GET |
/api/dns/zones/:id/backups/:bid |
Download a backup as JSON |
POST |
/api/dns/zones/:id/backups/:bid/restore |
Restore from a backup |
DELETE |
/api/dns/zones/:id/backups/:bid |
Delete a backup |
POST |
/api/dns/zones/:id/backups/enable |
Enable daily backups ($1/mo) |
POST |
/api/dns/zones/:id/backups/disable |
Disable daily backups |
Something unclear or out of date? Tell us