Sign in
Server Actions

Change reverse DNS entry for this Server

Changes the hostname that will appear when getting the hostname belonging to the primary IPs (IPv4 and IPv6) of this Server.

Floating IPs assigned to the Server are not affected by this.

post/servers/{id}/actions/change_dns_ptr

Request

  • Base URL: https://api.hetzner.cloud/v1
  • URL: https://api.hetzner.cloud/v1/servers/{id}/actions/change_dns_ptr
  • Auth: HTTP bearer

Path parameters

idinteger required

ID of the Server.

Example:42

ID of the Server.

Request body

ipstring required

Single IPv4 or IPv6 address to create pointer for.

dns_ptrstring nullable required

Domain Name to point to.

PTR record content used for reverse DNS. Set to null to reset (IPv4) to the default value or remove (IPv6) the record.

Example request

{
  "ip": "2001:db8::1",
  "dns_ptr": "server.example.com"
}

Response

Request succeeded.

Example response

{
  "action": {
    "id": 42,
    "command": "start_resource",
    "started": "2016-01-30T23:55:00Z",
    "finished": "2016-01-30T23:55:00Z",
    "progress": 100,
    "resources": [
      {
        "id": 42,
        "type": "server"
      }
    ],
    "error": {
      "code": "action_failed",
      "message": "Action failed"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.