VPS Power Action

Execute a power action on a VPS: start, stop, or restart.

Request

POST /api/v1/vps/{id}/power

Required scope: vps:write

Path Parameters

Parameter	Type	Description
`id`	string	The VPS ID

Headers

Header	Required	Value
`Authorization`	Yes	`Bearer YOUR_API_KEY`
`Content-Type`	Yes	`application/json`

Request Body

Field	Type	Required	Description
`action`	string	Yes	One of `start`, `stop`, or `restart`

{
  "action": "restart"
}

Response

{
  "data": {
    "action": "restart",
    "success": true
  }
}

Response Fields

Field	Type	Description
`action`	string	The power action that was executed
`success`	boolean	Whether the action was accepted

Errors

Status	Code	Description
400	`INVALID_ACTION`	The `action` value is not `start`, `stop`, or `restart`
404	`NOT_FOUND`	VPS not found or not accessible
502	`PROVIDER_ERROR`	Upstream provider error

Example

curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/power" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action": "restart"}'

MCP

This action is also available via the vm_power MCP tool.