---
title: "Start recovery mode"
method: POST
path: "/api/vps/v1/virtual-machines/{virtualMachineId}/recovery"
tags: ["VPS: Recovery"]
---

# Start recovery mode

`POST /api/vps/v1/virtual-machines/{virtualMachineId}/recovery`

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.

## Path parameters

- `virtualMachineId` integer, required

## Request body

- VPSV1VirtualMachineRecoveryStartRequest
  - `root_password` string, required — Temporary root password for recovery mode

## Response `200`

Success response

- VPSV1ActionActionResource
  - `id` integer — Action ID
  - `name` string — Action name
  - `state` 'success' | 'error' | 'delayed' | 'sent' | 'created' — Action state
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401` — Unauthenticated response
- `422` — Validation error response
- `500` — Error response

---

[API](https://skmtc.net/hostinger/apis/hostinger-api.md) · [All operations](https://skmtc.net/hostinger/apis/hostinger-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hostinger/hostinger-api/versions/796bd5194565/schema)