Manage DNS records

# All records
curl -s "https://api.godaddy.com/v3/domains/zones/example.com/dns-records" \
  -H "Authorization: Bearer $GODADDY_PAT"

# Filter by type
curl -s "https://api.godaddy.com/v3/domains/zones/example.com/dns-records?type=A" \
  -H "Authorization: Bearer $GODADDY_PAT"

# Filter by type and name
curl -s "https://api.godaddy.com/v3/domains/zones/example.com/dns-records?type=TXT&name=_acme-challenge" \
  -H "Authorization: Bearer $GODADDY_PAT"

const pat = process.env.GODADDY_PAT;
const zone = "example.com";
const url = new URL(`https://api.godaddy.com/v3/domains/zones/${zone}/dns-records`);
url.searchParams.set("type", "TXT");
url.searchParams.set("name", "_acme-challenge");

const res = await fetch(url, {
  headers: { Authorization: `Bearer ${pat}` },
});
const records = await res.json();
console.log(records.items);

import os, requests

pat = os.environ["GODADDY_PAT"]
zone = "example.com"

res = requests.get(
    f"https://api.godaddy.com/v3/domains/zones/{zone}/dns-records",
    params={"type": "TXT", "name": "_acme-challenge"},
    headers={"Authorization": f"Bearer {pat}"},
)
res.raise_for_status()
for record in res.json()["items"]:
    print(record["name"], record["type"], record["data"])

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "os"
)

func main() {
    pat := os.Getenv("GODADDY_PAT")
    zone := "example.com"

    u, _ := url.Parse(fmt.Sprintf("https://api.godaddy.com/v3/domains/zones/%s/dns-records", zone))
    q := u.Query()
    q.Set("type", "TXT")
    q.Set("name", "_acme-challenge")
    u.RawQuery = q.Encode()

    req, _ := http.NewRequest("GET", u.String(), nil)
    req.Header.Set("Authorization", "Bearer "+pat)

    res, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer res.Body.Close()

    var body struct {
        Items []map[string]any `json:"items"`
    }
    json.NewDecoder(res.Body).Decode(&body)
    fmt.Println(body.Items)
}

curl -s -X POST "https://api.godaddy.com/v3/domains/zones/example.com/dns-records" \
  -H "Authorization: Bearer $GODADDY_PAT" \
  -H "Content-Type: application/json" \
  -d '{ "type": "TXT", "name": "_acme-challenge", "data": "verification-string", "ttl": 600 }'

const pat = process.env.GODADDY_PAT;
const zone = "example.com";

const res = await fetch(
  `https://api.godaddy.com/v3/domains/zones/${zone}/dns-records`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${pat}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ type: "TXT", name: "_acme-challenge", data: "verification-string", ttl: 600 }),
  },
);
const record = await res.json();
console.log("Created record", record.recordId);

import os, requests

pat = os.environ["GODADDY_PAT"]
zone = "example.com"

res = requests.post(
    f"https://api.godaddy.com/v3/domains/zones/{zone}/dns-records",
    json={"type": "TXT", "name": "_acme-challenge", "data": "verification-string", "ttl": 600},
    headers={
        "Authorization": f"Bearer {pat}",
        "Content-Type": "application/json",
    },
)
res.raise_for_status()
print("Created record", res.json()["recordId"])

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

func main() {
    pat := os.Getenv("GODADDY_PAT")
    zone := "example.com"

    body := bytes.NewReader([]byte(
        `{"type":"TXT","name":"_acme-challenge","data":"verification-string","ttl":600}`))
    req, _ := http.NewRequest("POST",
        fmt.Sprintf("https://api.godaddy.com/v3/domains/zones/%s/dns-records", zone), body)
    req.Header.Set("Authorization", "Bearer "+pat)
    req.Header.Set("Content-Type", "application/json")

    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()

    var record struct{ RecordID string `json:"recordId"` }
    json.NewDecoder(res.Body).Decode(&record)
    fmt.Println("Created record", record.RecordID)
}

curl -s -X DELETE "https://api.godaddy.com/v3/domains/zones/example.com/dns-records/$RECORD_ID" \
  -H "Authorization: Bearer $GODADDY_PAT"

const pat = process.env.GODADDY_PAT;
const zone = "example.com";
const recordId = process.env.RECORD_ID;

const res = await fetch(
  `https://api.godaddy.com/v3/domains/zones/${zone}/dns-records/${recordId}`,
  {
    method: "DELETE",
    headers: { Authorization: `Bearer ${pat}` },
  },
);
console.log(res.status); // expect 204

import os, requests

pat = os.environ["GODADDY_PAT"]
zone = "example.com"
record_id = os.environ["RECORD_ID"]

res = requests.delete(
    f"https://api.godaddy.com/v3/domains/zones/{zone}/dns-records/{record_id}",
    headers={"Authorization": f"Bearer {pat}"},
)
print(res.status_code)  # expect 204

package main

import (
    "fmt"
    "net/http"
    "os"
)

func main() {
    pat := os.Getenv("GODADDY_PAT")
    zone := "example.com"
    recordID := os.Getenv("RECORD_ID")

    req, _ := http.NewRequest("DELETE",
        fmt.Sprintf("https://api.godaddy.com/v3/domains/zones/%s/dns-records/%s", zone, recordID), nil)
    req.Header.Set("Authorization", "Bearer "+pat)

    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    fmt.Println(res.StatusCode) // expect 204
}

curl -s -X PUT "https://api.godaddy.com/v3/domains/domain-names/example.com/nameservers" \
  -H "Authorization: Bearer $GODADDY_PAT" \
  -H "Content-Type: application/json" \
  -d '["ns1.example-dns.com", "ns2.example-dns.com"]'

const pat = process.env.GODADDY_PAT;

const res = await fetch(
  "https://api.godaddy.com/v3/domains/domain-names/example.com/nameservers",
  {
    method: "PUT",
    headers: {
      Authorization: `Bearer ${pat}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(["ns1.example-dns.com", "ns2.example-dns.com"]),
  },
);
console.log(res.status); // expect 202

import os, requests

res = requests.put(
    "https://api.godaddy.com/v3/domains/domain-names/example.com/nameservers",
    json=["ns1.example-dns.com", "ns2.example-dns.com"],
    headers={
        "Authorization": f"Bearer {os.environ['GODADDY_PAT']}",
        "Content-Type": "application/json",
    },
)
print(res.status_code)  # expect 202

package main

import (
    "bytes"
    "fmt"
    "net/http"
    "os"
)

func main() {
    body := bytes.NewReader([]byte(`["ns1.example-dns.com","ns2.example-dns.com"]`))
    req, _ := http.NewRequest("PUT",
        "https://api.godaddy.com/v3/domains/domain-names/example.com/nameservers", body)
    req.Header.Set("Authorization", "Bearer "+os.Getenv("GODADDY_PAT"))
    req.Header.Set("Content-Type", "application/json")

    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    fmt.Println(res.StatusCode) // expect 202
}