API Documentation

Reinstall OS

Reinstall the operating system on a VPS. This is a destructive action — all data on the server will be erased.

Request

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

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
os string Yes The operating system identifier (e.g. ubuntu-24.04) 
{
  "os": "ubuntu-24.04"
}

Response

{
  "data": {
    "os": "ubuntu-24.04",
    "success": true
  }
}

Response Fields

Field Type Description
os string The operating system being installed
success boolean Whether the reinstall was initiated

Errors

Status Code Description
400 INVALID_OS The os field is missing or not a string
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/os" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"os": "ubuntu-24.04"}'

MCP

This action is also available via the vm_reinstall_os MCP tool.