Dns

DNS Management

Auth

# Set your DNS provider API key
DNS_API_KEY=""
DNS_API_BASE=""  # e.g., https://api.hosting.ionos.com/dns/v1/zones

Header: X-API-Key: $DNS_API_KEY (or Authorization: Bearer $DNS_API_KEY depending on provider)

Known Zone IDs

| Domain | Zone ID | |--------|---------| | example.com | `` |

Operations

List all zones (find zone ID)

curl -s -H "X-API-Key: $DNS_API_KEY" "$DNS_API_BASE" | jq '.[] | {name, id}'

List records for a zone

curl -s -H "X-API-Key: $DNS_API_KEY" "$DNS_API_BASE/{zoneId}" | jq '.records[] | {name, type, content, id}'
# Filter by type:
curl -s -H "X-API-Key: $DNS_API_KEY" "$DNS_API_BASE/{zoneId}?recordType=A"

Add record

curl -s -X POST \
  -H "X-API-Key: $DNS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"name":"sub.domain.com","type":"A","content":"1.2.3.4","ttl":3600}]' \
  "$DNS_API_BASE/{zoneId}/records"

Update record (need record ID first)

curl -s -X PUT \
  -H "X-API-Key: $DNS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content":"1.2.3.4","ttl":3600}' \
  "$DNS_API_BASE/{zoneId}/records/{recordId}"

Delete record

curl -s -X DELETE \
  -H "X-API-Key: $DNS_API_KEY" \
  "$DNS_API_BASE/{zoneId}/records/{recordId}"

Workflow

1. If zone ID unknown: list zones, find matching domain
2. List existing records for the zone
3. Add / update / delete as needed
4. Verify: dig sub.domain.com @8.8.8.8 (propagation takes 1-5 min)

Common Record Types

| Type | Use case | Example content | |------|----------|-----------------| | A | IPv4 | 93.184.216.34 | | CNAME | Alias | cname.vercel-dns.com | | TXT | Verification, SPF | "v=spf1 include:..." | | MX | Email | 10 smtp.example.com |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: floomhq
• Source: floomhq/moto
• License: MIT
• Homepage: https://github.com/floomhq/moto#readme

Install and usage instructions live in the source repository linked above.