API-Dokumentation

Betriebssystem neu installieren

Installiere das Betriebssystem eines VPS neu. Dies ist eine destruktive Aktion — alle Daten auf dem Server werden gelöscht.

Anfrage

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

Erforderlicher Scope: vps:write

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Feld Typ Erforderlich Beschreibung
os string Ja Die Betriebssystem-Kennung (z.B. ubuntu-24.04) 
{
  "os": "ubuntu-24.04"
}

Antwort

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

Antwortfelder

Feld Typ Beschreibung
os string Das zu installierende Betriebssystem
success boolean Ob die Neuinstallation gestartet wurde

Fehler

Status Code Beschreibung
400 INVALID_OS Das os-Feld fehlt oder ist kein String
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
502 PROVIDER_ERROR Upstream-Anbieterfehler

Beispiel

curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/os" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"os": "ubuntu-24.04"}'

MCP

Diese Aktion ist auch über das vm_reinstall_os MCP-Tool verfügbar.