Records
Add, update, delete, and proxy DNS records in Vorynza DNS.
DNS records define how traffic routes for your domain. Vorynza supports standard record types with optional proxy support.
Supported record types
| Type | Purpose | Proxyable |
|---|---|---|
| A | IPv4 address | Yes |
| AAAA | IPv6 address | Yes |
| CNAME | Canonical name (alias) | Yes |
| MX | Mail exchanger | No |
| TXT | Text records (SPF, DKIM, etc.) | No |
| NS | Nameserver delegation | No |
| CAA | Certification authority authorisation | No |
Creating a record
{
"type": "A",
"name": "www",
"value": "192.0.2.1",
"ttl": 300,
"proxied": false
}| Field | Required | Description |
|---|---|---|
type | yes | Record type (A, AAAA, CNAME, MX, TXT, NS, CAA) |
name | yes | Record name relative to the zone (e.g. www) |
value | yes | Record value |
ttl | no | Time to live in seconds (default 300) |
priority | no | Priority for MX records |
proxied | no | Enable proxy (A, AAAA, CNAME only) |
originProtocol | no | Protocol for proxy origin (http or https) |
originPort | no | Port for proxy origin |
originPath | no | Path for proxy origin |
originHostHeader | no | Host header sent to proxy origin |
Record proxy
Proxied records route traffic through Vorynza's edge network instead of connecting directly to the origin. This provides:
- DDoS protection
- SSL termination
- Traffic optimisation
- Origin IP masking
When a record is proxied, Vorynza serves edge IP addresses defined by VORYNZA_EDGE_IPV4S
and VORYNZA_EDGE_IPV6S (for A/AAAA records) or a VORYNZA_CNAME_TARGET (for CNAME records)
instead of the original record value.
Updating origin settings (protocol, port, path, host header) changes how the edge routes requests to your origin.
Proxy statuses
| Status | Description |
|---|---|
disabled | Proxy not enabled |
syncing | Proxy configuration being set up |
active | Proxy is active |
failed | Proxy configuration failed |
Record validation rules
- A records must be valid IPv4 addresses (private IPs are rejected when proxied)
- CNAME records cannot coexist with other records at the same name
- MX records require a priority value
- Proxy is only available for A, AAAA, and CNAME records
- System records (created by Mail auto-configuration) are locked and cannot be modified
Updating records
Use PATCH to update one or more fields of an existing record. Changing the name or type
also cleans up the old record set in PowerDNS.
Deleting records
Records are soft-deleted and can be restored within the dashboard. Bulk delete supports up to 100 records at once. System and locked records cannot be deleted.
Record API endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/orgs/:orgSlug/projects/:projectSlug/dns/zones/:zoneId/records | List records |
POST | /api/orgs/:orgSlug/projects/:projectSlug/dns/zones/:zoneId/records | Create record |
PATCH | /api/orgs/:orgSlug/projects/:projectSlug/dns/zones/:zoneId/records/:recordId | Update record |
DELETE | /api/orgs/:orgSlug/projects/:projectSlug/dns/zones/:zoneId/records/:recordId | Delete record |
POST | /api/orgs/:orgSlug/projects/:projectSlug/dns/zones/:zoneId/records/bulk-delete | Bulk delete |
POST | /api/orgs/:orgSlug/projects/:projectSlug/dns/zones/:zoneId/records/:recordId/restore | Restore record |
Need help? Contact support.