Start recovery mode

Initiate recovery mode for a specified virtual machine.

Start recovery mode

post

Initiate recovery mode for a specified virtual machine.

Recovery mode is a special state that allows users to perform system rescue operations, such as repairing file systems, recovering data, or troubleshooting issues that prevent the virtual machine from booting normally.

Virtual machine will boot recovery disk image and original disk image will be mounted in /mnt directory.

Use this endpoint to enable system rescue operations on VPS instances.

Authorizations

AuthorizationstringRequired

API Token authentication

Path parameters

virtualMachineIdintegerRequired

Virtual Machine ID

Example: 1268054

Body

root_passwordstringRequired

Temporary root password for recovery mode

Example: oMeNRustosIO

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

post/api/vps/v1/virtual-machines/{virtualMachineId}/recovery

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

{
  "root_password": "oMeNRustosIO"
}

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