API-Dokumentation

Passwort zurücksetzen

Generiere ein neues Root-Passwort für einen VPS. Das neue Passwort wird in der Antwort zurückgegeben und sollte sicher gespeichert werden.

Anfrage

POST /api/v1/vps/{id}/reset-password

Erforderlicher Scope: vps:write

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Es ist kein Anfragekörper erforderlich.

Antwort

{
  "data": {
    "password": "aB3$kLm9pQr2"
  }
}

Antwortfelder

Feld Typ Beschreibung
password string Das neu generierte Root-Passwort

Fehler

Status Code Beschreibung
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/reset-password" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL"

MCP

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