---
title: "Start, stop or restart · API | Rdp.Vision"
description: "POST /servers/{id}/power: Changes the power state. A restart takes about a minute on Linux and a few minutes on Windows. Refused while a new or reinstalled serv"
url: https://rdp.vision/docs/api/servers/power
---

Open in AI

[ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Frdp.vision%2Fdocs%2Fapi%2Fservers%2Fpower.md%20and%20help%20me%20use%20the%20Rdp.Vision%20API.)[Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Frdp.vision%2Fdocs%2Fapi%2Fservers%2Fpower.md%20and%20help%20me%20use%20the%20Rdp.Vision%20API.)

Servers

# Start, stop or restart

Changes the power state. A restart takes about a minute on Linux and a few minutes on Windows. Refused while a new or reinstalled server is still setting up.

POST`/servers/{id}/power`

## Authorization

`Authorization`header required

`Bearer rv_…`, a key with the `power` scope. [About keys](https://rdp.vision/docs/api/authentication)

## Path parameters

`id`string (uuid) required

The server id from List servers.

## Body

application/json

`action`string required

reset restarts the server.

One of `start``stop``reset`

## Status codes

- 200 | Success.
- 401 | No key, a wrong key, or a revoked or expired one.
- 403 | The key lacks the scope, the endpoint isn’t open to keys, the balance is frozen or the server is suspended.
- 409 | The server is busy, for example still setting up after an order or reinstall.
- 429 | More than 120 requests a minute with one key, or too many wrong keys from one address.

Request

curl -X POST "https://rdp.vision/api/v1/servers/3f6c2a8e-91d4-4b7a-a5e2-7c0d9b1f4e36/power" \\
  -H "Authorization: Bearer $RDPVISION\_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{"action":"reset"}'

Response

{
  "success": true
}