---
title: "Run VM power action"
method: POST
path: "/virtual_machines/{virtual_machine_id}/actions"
tags: ["Virtual machines"]
---

# Run VM power action

`POST /virtual_machines/{virtual_machine_id}/actions`

Performs a power action on a given virtual machine:
- `power_on` - Starts the virtual machine
- `power_off` - Stops the virtual machine
- `reboot` - Restarts the virtual machine

## Path parameters

- `virtual_machine_id` string, required

## Request body

- object
  - `id` string, required
  - `type` 'virtual_machines', required
  - `attributes` object, required
    - `action` 'power_on' | 'power_off' | 'reboot', required — The action to perform on the virtual machine

## Response `201`

Created

---

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