A PTR record maps an IP address to a hostname through the address owner's reverse DNS authority. Domain Nexus accepts reverse DNS requests only within the account's permitted address and server assignments. Owning a forward domain is not evidence that you control its server's public IP allocation.
| Method | Resource | Scope | Idempotency-Key |
|---|---|---|---|
GET |
/v2/dns/rdns |
dns:read |
Not required by this route |
POST |
/v2/dns/rdns |
dns:rdns |
Required |
PATCH |
/v2/dns/rdns/{rdnsId} |
dns:rdns |
Required |
DELETE |
/v2/dns/rdns/{rdnsId} |
dns:rdns |
Required |
01 Create a permitted PTR
- Identify who supplies the public address and whether your plan allows reverse DNS management. Obtain the relevant address or network assignment reference.
- Choose the intended fully qualified hostname, such as
mail.example.com, and configure its forward A or AAAA record to the appropriate public address. - List existing reverse DNS resources so you do not create a duplicate request for the same assignment.
- POST
ipandptr_hostname. Includeprefix_length, an eligibleserver_idorownership_referencewhen your assigned reverse zone requires them. - Record the returned public resource ID, task state and errors. Verify the resulting reverse answer through the delegated reverse DNS authority.
02 Change or remove an existing entry
PATCH the resource ID with both ip and ptr_hostname; this contract requires those values even for an update. Supply the current row version using If-Match when coordinating concurrent administration. On a stale-version conflict, reload the resource and compare changes before trying again.
DELETE removes the permitted reverse DNS entry. First check mail delivery, monitoring and any application that relies on its hostname. Each mutation requires its own idempotency key; repeat the same request with its existing key only when recovering an uncertain transport result.
Common questions
Can I add the PTR in example.com's normal DNS zone?
The reverse lookup follows the IP address's reverse delegation, not the forward domain's zone. Use the address provider's supported workflow or the assigned reverse DNS service.
Does a PTR guarantee email delivery?
No. It contributes to a coherent mail-server identity. The hostname's forward records, SMTP configuration, authentication and reputation also matter.
Why is an address rejected even though my website uses it?
A website can point at an address without having permission to manage that address's reverse zone. Ask the hosting or network operator to confirm the authorised assignment.