Skip to content

Knowledgebase

Create or change an authorised PTR record through the API

domain-nexus, development

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

  1. Identify who supplies the public address and whether your plan allows reverse DNS management. Obtain the relevant address or network assignment reference.
  2. Choose the intended fully qualified hostname, such as mail.example.com, and configure its forward A or AAAA record to the appropriate public address.
  3. List existing reverse DNS resources so you do not create a duplicate request for the same assignment.
  4. POST ip and ptr_hostname. Include prefix_length, an eligible server_id or ownership_reference when your assigned reverse zone requires them.
  5. 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.

Was this answer helpful?

Need a little more help?

Our support team can help you find the next step.

Contact support