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

Authorizationheaderrequired

Bearer rv_…, a key with the power scope. About keys

Path parameters

idstring (uuid)required

The server id from List servers.

Body

application/json

actionstringrequired

reset restarts the server.

One of startstopreset

Status codes

200Success.

401No key, a wrong key, or a revoked or expired one.

403The key lacks the scope, the endpoint isn’t open to keys, the balance is frozen or the server is suspended.

409The server is busy, for example still setting up after an order or reinstall.

429More than 120 requests a minute with one key, or too many wrong keys from one address.