Register Custom Nameserver (Glue Record)

Registering Custom Nameservers (Glue Records): This advanced endpoint builds glue records mapping static IPs directly. To handle complex structural configurations smoothly, there's internal concatenation: if the provided nameserver string parameter purposefully does NOT contain a dot (.), the API securely evaluates and will automatically append the FQDN to the string (creating strings like ns1.yourdomain.com under the hood before calling Dynadot).

Endpoint: POST /{id}/register-nameserver

Parameters:

  • id (required, URL parameter): The local ID of the domain
  • nameserver (required, string): The unique prefix (e.g., 'ns1') or the full FQDN format.
  • ip (required, string/IP): The static IPv4 address. Evaluated with standard strict required|ip Laravel validation.

Example Request:

curl -X POST "https://umva.net/api/domain/123/register-nameserver" 
  -H "X-API-Key: your_api_key_here" 
  -H "Content-Type: application/json" 
  -d '{"nameserver": "ns1", "ip": "10.0.0.1"}'

Success Response Example (HTTP 200):

{
  "success": true,
  "message": "Nameserver registered successfully.",
  "data": {
    "domain": "example.com",
    "nameserver": "ns1",
    "ip": "10.0.0.1"
  }
}

Error Response Example (Validation issue - HTTP 422):

{
  "message": "The given data was invalid.",
  "errors": {
    "ip": ["The ip must be a valid IP address."]
  }
}