DNS records

These endpoints manage the DNS zone hosted by the registry for your domain. The records are served only while the domain uses the registry's default nameservers. If you point the domain to other nameservers, manage its DNS with that provider instead.

{id} is the domain id from GET /domains/mine. A domain with status pending_profile returns 409 DOMAIN_PENDING_PROFILE.

Record typesCopy Anchor Link

List recordsCopy Anchor Link

curl https://api.helipod.io/api/domains/42/dns \
  -H "Authorization: Bearer hel_your_key"

{
  "success": true,
  "data": [
    { "prefix": "@",   "name": "example.com",     "type": "A",     "content": "203.0.113.10", "ttl": 3600 },
    { "prefix": "www", "name": "www.example.com", "type": "CNAME", "content": "example.com",  "ttl": 3600 }
  ]
}

When you write records, the name field takes the prefix (@, www), not the full name.

Set recordsCopy Anchor Link

curl -X POST https://api.helipod.io/api/domains/42/dns \
  -H "Authorization: Bearer hel_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      { "name": "@",    "type": "A",     "content": "203.0.113.10" },
      { "name": "www",  "type": "CNAME", "content": "example.com" },
      { "name": "@",    "type": "MX",    "content": "mail.example.com", "ttl": 3600 },
      { "name": "@",    "type": "TXT",   "content": "v=spf1 include:_spf.example.net ~all" }
    ]
  }'

{ "success": true, "message": "DNS records created" }

If the registry rejects the set (for example a CNAME on a name that already has other records), the response is 422 with code REGISTRAR_REJECTED. Read the records again to see the current state.

Update a recordCopy Anchor Link

curl -X PUT https://api.helipod.io/api/domains/42/dns \
  -H "Authorization: Bearer hel_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "name": "@", "type": "A", "content": "203.0.113.11", "ttl": 600 }'

{ "success": true, "message": "DNS record updated" }

Use this for a name that has a single record of the given type. When a name has several records of the same type (for example two MX records), use Set records with the full list instead.

Delete a recordCopy Anchor Link

The record to delete goes in the JSON body. name, type and content must match the record exactly.

curl -X DELETE https://api.helipod.io/api/domains/42/dns \
  -H "Authorization: Bearer hel_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "name": "www", "type": "CNAME", "content": "example.com" }'

{ "success": true, "message": "DNS record deleted" }

ErrorsCopy Anchor Link