---
title: "Stop virtual machine"
method: POST
path: "/api/vps/v1/virtual-machines/{virtualMachineId}/stop"
tags: ["VPS: Virtual machine"]
---

# Stop virtual machine

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

Stop a specified virtual machine.

If the virtual machine is already stopped, the request will still be processed without any effect.

This is a compute-only power state change and does not affect billing. To stop future charges,
disable auto-renewal on the owning subscription.

Use this endpoint to power off running VPS instances.

## Path parameters

- `virtualMachineId` integer, required

## 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
- `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)