Zones
Create, verify, sync, and manage DNS zones in Vorynza DNS.
A zone is a container for DNS records belonging to a domain. Each zone has a status, hosting mode, and optional custom nameservers.
Zone statuses
| Status | Description |
|---|---|
pending | Zone created, waiting for nameserver verification |
syncing | Zone being synced to PowerDNS |
active | Zone is live and accepting record changes |
failed | Nameserver verification or sync failed |
suspended | Zone suspended (billing or policy) |
deleted | Zone soft-deleted |
Creating a zone
When you add a domain, Vorynza scans it to detect current nameservers and existing records. You can then choose the hosting mode and optionally set custom nameservers.
{
"domain": "example.com",
"mode": "full_hosting",
"customNameservers": ["ns1.example.com", "ns2.example.com"]
}For full hosting zones, creation syncs the zone to PowerDNS and enqueues a sync job for each discovered record.
Domain scanning
Adding a domain triggers a live DNS scan that:
- Resolves current NS records via Cloudflare (1.1.1.1) and Google (8.8.8.8) DNS
- Discovers A, AAAA, CNAME, MX, and TXT records
- Detects whether the domain already points to Vorynza nameservers
- Returns warnings for missing or mismatched nameservers
Nameserver verification
After pointing your domain to Vorynza nameservers, trigger verification from the dashboard.
Vorynza resolves NS records and updates the zone status to active when confirmed.
Propagation can take from a few minutes to 48 hours depending on your registrar and TTL.
Syncing
The sync operation pushes the current zone state to PowerDNS. This happens automatically when records change, but can also be triggered manually.
For external zones, sync is not applicable — Vorynza does not manage the DNS provider.
Zone API endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/orgs/:orgSlug/projects/:projectSlug/dns/zones | List zones |
POST | /api/orgs/:orgSlug/projects/:projectSlug/dns/zones | Create zone |
POST | /api/orgs/:orgSlug/projects/:projectSlug/dns/scan | Scan a domain |
GET | /api/orgs/:orgSlug/projects/:projectSlug/dns/zones/:zoneId | Get zone |
DELETE | /api/orgs/:orgSlug/projects/:projectSlug/dns/zones/:zoneId | Delete zone |
POST | /api/orgs/:orgSlug/projects/:projectSlug/dns/zones/:zoneId/verify | Verify nameservers |
POST | /api/orgs/:orgSlug/projects/:projectSlug/dns/zones/:zoneId/sync | Sync zone |
Need help? Contact support.
