API-Dokumentation

VPS umbenennen

Aktualisiere den Anzeigenamen eines VPS. Dies ist ein lokaler Vorgang und hat keine Auswirkung auf den Hosting-Anbieter.

Anfrage

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

Erforderlicher Scope: vps:manage

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
name string Ja Neuer Anzeigename (1–32 Zeichen)
{
  "name": "Produktionsserver"
}

Antwort

{
  "data": {
    "name": "Produktionsserver",
    "success": true
  }
}

Antwortfelder

Feld Typ Beschreibung
name string Der neue Anzeigename
success boolean Ob die Umbenennung erfolgreich war

Fehler

Status Code Beschreibung
400 INVALID_NAME Der Name muss 1–32 Zeichen lang sein
400 INVALID_BODY Der Anfragekörper ist kein gültiges JSON
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff

Beispiel

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

MCP

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