ResolvXResolvX

Records

Managing DNS records in ResolvX

DNS Records

DNS records are the building blocks of your zones. ResolvX supports all common DNS record types.

Supported Record Types

TypeDescriptionExample Value
AIPv4 address192.168.1.100
AAAAIPv6 address2001:db8::1
CNAMECanonical name (alias)www.example.com.
MXMail exchange10 mail.example.com.
TXTText record"v=spf1 include:_spf.google.com ~all"
NSNameserverns1.example.com.
SRVService record10 5 5060 sip.example.com.
PTRPointer (reverse DNS)www.example.com.
CAACertificate Authority Authorization0 issue "letsencrypt.org"

Creating Records

Via Dashboard

  1. Navigate to Records in the sidebar
  2. Select a zone from the dropdown
  3. Click Add Record
  4. Fill in the record details
  5. Click Create

Via API

# A Record
curl -X POST http://localhost:8080/api/v1/zones/example.com/records \
  -H "Content-Type: application/json" \
  -d '{
    "name": "www",
    "type": "A",
    "value": "192.168.1.100",
    "ttl": 300
  }'

# CNAME Record
curl -X POST http://localhost:8080/api/v1/zones/example.com/records \
  -H "Content-Type: application/json" \
  -d '{
    "name": "blog",
    "type": "CNAME",
    "value": "www.example.com.",
    "ttl": 300
  }'

# MX Record
curl -X POST http://localhost:8080/api/v1/zones/example.com/records \
  -H "Content-Type: application/json" \
  -d '{
    "name": "@",
    "type": "MX",
    "value": "mail.example.com.",
    "priority": 10,
    "ttl": 300
  }'

# TXT Record
curl -X POST http://localhost:8080/api/v1/zones/example.com/records \
  -H "Content-Type: application/json" \
  -d '{
    "name": "@",
    "type": "TXT",
    "value": "v=spf1 include:_spf.google.com ~all",
    "ttl": 300
  }'

Via CLI

# A Record
resolvx record create example.com www A 192.168.1.100 --ttl 300

# CNAME Record
resolvx record create example.com blog CNAME www.example.com. --ttl 300

# MX Record
resolvx record create example.com @ MX mail.example.com. --priority 10 --ttl 300

Listing Records

Via API

# All records in a zone
curl http://localhost:8080/api/v1/zones/example.com/records

# Filter by type
curl "http://localhost:8080/api/v1/zones/example.com/records?type=A"

# Filter by name
curl "http://localhost:8080/api/v1/zones/example.com/records?name=www"

Via CLI

resolvx record list example.com
resolvx record list example.com --type A

Updating Records

Via API

curl -X PUT http://localhost:8080/api/v1/zones/example.com/records/{record_id} \
  -H "Content-Type: application/json" \
  -d '{
    "value": "192.168.1.200",
    "ttl": 600
  }'

Deleting Records

Via API

curl -X DELETE http://localhost:8080/api/v1/zones/example.com/records/{record_id}

Via CLI

resolvx record delete example.com {record_id}

Record Name Conventions

  • Use @ for the zone apex (e.g., example.com itself)
  • Use relative names without the zone suffix (e.g., www not www.example.com)
  • CNAME targets should end with a dot (.) if fully qualified

TTL (Time To Live)

TTL controls how long DNS resolvers cache a record:

TTLUse Case
60-300sRecords that change frequently
300-3600sStandard records
3600-86400sStable records

Lower TTLs mean faster propagation of changes but more DNS queries to your server.

Next Steps

On this page