Skip to main content

Nameserver Management

This page covers domain nameservers and child nameserver / host object / glue record operations. All operations require the username and token headers.

Get Nameservers​

GET /domains/{domain}/nameservers

Gets nameservers for a domain.

Path variable:

  • domain: domain name, for example example.test.ly
Get nameservers
curl --request GET \
  --url "https://my.register.ly/modules/addons/DomainsReseller/api/index.php/domains/example.test.ly/nameservers" \
  --header "username: [email protected]" \
  --header "token: <generated-token>"

HTTP 200 success response:

{
  "ns1": "ns1.ns.ly",
  "ns2": "ns2.ns.ly",
  "ns3": "ns3.ns.ly",
  "ns4": "ns4.ns.ly",
  "ns5": "",
  "status": "success",
  "message": ""
}

VALIDATION REQUIRED: Confirm minimum/maximum nameservers, whether omitting or sending an empty ns3-ns5 removes an existing value, hostname normalization, trailing-dot behavior, and errors.

Save Nameservers​

POST /domains/{domain}/nameservers

Path variable:

  • domain: domain name, for example example.test.ly

Request parameters:

  • ns1: nameserver, for example ns1.ls.ly
  • ns2: nameserver, for example ns2.ls.ly
  • ns3: nameserver, for example ns3.ls.ly
  • ns4: nameserver, for example ns4.ls.ly
  • ns5: nameserver, for example ns5.ls.ly
Save nameservers
curl --request POST \
  --url "https://my.register.ly/modules/addons/DomainsReseller/api/index.php/domains/example.test.ly/nameservers" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "username: [email protected]" \
  --header "token: <generated-token>" \
  --data-urlencode "ns1=ns1.example.net" \
  --data-urlencode "ns2=ns2.example.net"

HTTP 200 success response:

{
  "status": "success",
  "message": ""
}

Register Nameserver​

POST /domains/{domain}/nameservers/register

Creates a child nameserver / host object (commonly called a glue record) for the domain. For example, for example.ly, create ns1.example.ly.

Path variable:

  • domain: domain name, for example example.test.ly

Request parameters:

  • nameserver: custom nameserver, for example ns1.example.test.ly
  • ipaddress: IP address, for example 192.168.1.1
Register child nameserver
curl --request POST \
  --url "https://my.register.ly/modules/addons/DomainsReseller/api/index.php/domains/example.test.ly/nameservers/register" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "username: [email protected]" \
  --header "token: <generated-token>" \
  --data-urlencode "nameserver=ns1.example.test.ly" \
  --data-urlencode "ipaddress=192.0.2.10"

HTTP 200 success response:

"success"

VALIDATION REQUIRED: Confirm IPv4/IPv6 support, multiple addresses per host object, ownership requirements, duplicate behavior, and response errors.

Modify Nameserver​

POST /domains/{domain}/nameservers/modify

Updates a custom nameserver IP address.

Path variable:

  • domain: domain name, for example example.test.ly

Request parameters:

  • nameserver: custom nameserver, for example ns1.example.test.ly
  • currentipaddress: current IP address, for example 192.168.1.1
  • newipaddress: new IP address, for example 192.168.1.2
Modify child nameserver
curl --request POST \
  --url "https://my.register.ly/modules/addons/DomainsReseller/api/index.php/domains/example.test.ly/nameservers/modify" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "username: [email protected]" \
  --header "token: <generated-token>" \
  --data-urlencode "nameserver=ns1.example.test.ly" \
  --data-urlencode "currentipaddress=192.0.2.10" \
  --data-urlencode "newipaddress=192.0.2.11"

HTTP 200 success response:

"success"

VALIDATION REQUIRED: Confirm whether a host object can have multiple IPs and how current-address mismatches are reported.

Delete Nameserver​

POST /domains/{domain}/nameservers/delete

Deletes a custom nameserver for the domain.

Path variable:

  • domain: domain name, for example example.test.ly

Request parameter:

  • nameserver: custom nameserver, for example ns1.example.test.ly
Delete child nameserver
curl --request POST \
  --url "https://my.register.ly/modules/addons/DomainsReseller/api/index.php/domains/example.test.ly/nameservers/delete" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "username: [email protected]" \
  --header "token: <generated-token>" \
  --data-urlencode "nameserver=ns1.example.test.ly"

HTTP 200 success response:

"success"

VALIDATION REQUIRED: Confirm preconditions, behavior when the host object is in use, not-found behavior, and retry safety.