Stop virtual machine

Stop a specified virtual machine.

Stop virtual machine

post

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.

Authorizations

AuthorizationstringRequired

API Token authentication

Path parameters

virtualMachineIdintegerRequired

Virtual Machine ID

Example: 1268054

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

500

Error response

application/json

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

POST /api/vps/v1/virtual-machines/{virtualMachineId}/stop HTTP/1.1
Host: developers.hostinger.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

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