VPS: Recovery

Start recovery mode

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.

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

Request

  • Base URL: https://developers.hostinger.com
  • URL: https://developers.hostinger.com/api/vps/v1/virtual-machines/{virtualMachineId}/recovery
  • Auth: HTTP bearer

Path parameters

virtualMachineIdinteger required
Example:1268054

Virtual Machine ID

Request body

root_passwordstring required

Temporary root password for recovery mode

Example request

{
  "root_password": "oMeNRustosIO"
}

Response

Success response

idinteger

Action ID

namestring

Action name

state'success' | 'error' | 'delayed' | 'sent' | 'created'

Action state

created_atstring date-time
updated_atstring date-time

Example response

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

Changes

No recorded changes to this operation across all 130 revisions of this API.