Set hostname

Set hostname for a specified virtual machine.

Set hostname

put

Set hostname for a specified virtual machine.

Changing hostname does not update PTR record automatically. If you want your virtual machine to be reachable by a hostname, you need to point your domain A/AAAA records to virtual machine IP as well.

Use this endpoint to configure custom hostnames for VPS instances.

Authorizations

AuthorizationstringRequired

API Token authentication

Path parameters

virtualMachineIdintegerRequired

Virtual Machine ID

Example: 1268054

Body

hostnamestringRequiredExample: my.server.tld

Responses

200

Success response

application/json

idintegerOptional

Action ID

Example: 8123712

namestringOptional

Action name

Example: action_name

statestring · enumOptional

Action state

Example: successPossible values:

created_atstring · date-timeOptionalExample: 2025-02-27T11:54:00Z

updated_atstring · date-timeOptionalExample: 2025-02-27T11:58:00Z

401

Unauthenticated response

application/json

422

Validation error response

application/json

500

Error response

application/json

put/api/vps/v1/virtual-machines/{virtualMachineId}/hostname

PUT /api/vps/v1/virtual-machines/{virtualMachineId}/hostname HTTP/1.1
Host: developers.hostinger.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "hostname": "my.server.tld"
}

{
  "id": 8123712,
  "name": "action_name",
  "state": "success",
  "created_at": "2025-02-27T11:54:00Z",
  "updated_at": "2025-02-27T11:58:00Z"
}