API-Dokumentation

Sicherungen auflisten

Gibt alle vorhandenen Sicherungen eines VPS zurück.

Erforderlicher Scope: vps:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": [
    {
      "backupId": "backup_abc123",
      "os": "Ubuntu 22.04",
      "description": "Tägliche Sicherung",
      "label": "Vor Update",
      "size": 5368709120,
      "created": "2026-03-27T02:00:00Z",
      "status": "finished"
    }
  ]
}

Antwortfelder

Feld Typ Beschreibung
backupId string Eindeutige Sicherungs-ID
os string Betriebssystem zum Zeitpunkt der Sicherung
description string Beschreibung der Sicherung
label string | null Benutzerdefinierte Bezeichnung, oder null wenn nicht gesetzt
size integer Größe der Sicherung in Bytes
created string ISO-8601-Erstellungszeitstempel
status string finished oder pending

Fehler

Status Code Beschreibung
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff

Beispiel

curl "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/backups" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL"

MCP

Diese Daten sind auch über das list_backups MCP-Tool verfügbar.

Sicherung erstellen

Erstellt eine neue Sicherung des VPS. Der Sicherungsvorgang läuft asynchron.

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 (optional)

Feld Typ Beschreibung
label string Optionale Bezeichnung für die Sicherung (max. 100 Zeichen)
{
  "label": "Vor Update"
}

Antwort

{
  "data": {
    "backupId": "backup_def456",
    "label": "Vor Update",
    "success": true
  }
}

Fehler

Status Code Beschreibung
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
409 NO_SLOTS Keine Sicherungsplätze verfügbar
502 PROVIDER_ERROR Upstream-Anbieterfehler

Beispiel

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

MCP

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

Sicherung wiederherstellen

Stellt einen VPS aus einer bestimmten Sicherung wieder her. Dies überschreibt den aktuellen Zustand des VPS.

Erforderlicher Scope: vps:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID
backupId string Die Sicherungs-ID zur Wiederherstellung

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Es ist kein Anfragekörper erforderlich.

Antwort

{
  "data": {
    "backupId": "backup_abc123",
    "success": true
  }
}

Fehler

Status Code Beschreibung
400 INVALID_BACKUP_ID Sicherungs-ID fehlt oder ist ungültig
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/backups/backup_abc123" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL"

MCP

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

Sicherung löschen

Löscht eine Sicherung dauerhaft.

Erforderlicher Scope: vps:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID
backupId string Die zu löschende Sicherungs-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "backupId": "backup_abc123",
    "success": true
  }
}

Fehler

Status Code Beschreibung
400 INVALID_BACKUP_ID Sicherungs-ID fehlt oder ist ungültig
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
502 PROVIDER_ERROR Upstream-Anbieterfehler

Beispiel

curl -X DELETE "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/backups/backup_abc123" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL"

MCP

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

Firewall-Status abrufen

Gibt den aktuellen Firewall-Status und alle Regeln eines VPS zurück. Die Firewall-Verwaltung erfolgt über SSH (unterstützt ufw und firewalld).

Erforderlicher Scope: vps:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "tool": "ufw",
    "active": true,
    "defaultIncoming": "deny",
    "defaultOutgoing": "allow",
    "rules": [
      {
        "port": "22",
        "proto": "tcp",
        "action": "allow",
        "source": "any"
      },
      {
        "port": "80",
        "proto": "tcp",
        "action": "allow",
        "source": "any"
      },
      {
        "port": "443",
        "proto": "tcp",
        "action": "allow",
        "source": "any"
      }
    ],
    "readViaSSH": true
  }
}

Antwortfelder

Feld Typ Beschreibung
tool string Erkanntes Firewall-Tool (ufw, firewalld oder none)
active boolean Ob die Firewall derzeit aktiv ist
defaultIncoming string Standardrichtlinie für eingehenden Datenverkehr
defaultOutgoing string Standardrichtlinie für ausgehenden Datenverkehr
rules array Liste der Firewall-Regeln
rules[].port string Port oder Portbereich (z.B. 80, 8000:8100)
rules[].proto string Protokoll: tcp, udp oder both
rules[].action string allow oder deny
rules[].source string Quell-IP oder any
readViaSSH boolean Ob der Status per SSH gelesen wurde

Fehler

Status Code Beschreibung
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
502 FIREWALL_ERROR Firewall-Operation auf dem Server fehlgeschlagen

Beispiel

curl "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/firewall" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL"

MCP

Diese Daten sind auch über das get_firewall MCP-Tool verfügbar.

Firewall-Regel hinzufügen

Fügt eine neue Firewall-Regel zu einem VPS hinzu.

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
port string Ja Port oder Portbereich (z.B. 80, 8000:8100)
proto string Ja Protokoll: tcp, udp oder both
action string Ja allow oder deny
source string Nein Quell-IP-Adresse (Standard: any)
comment string Nein Optionaler Kommentar für die Regel
{
  "port": "8080",
  "proto": "tcp",
  "action": "allow",
  "source": "any",
  "comment": "Web-App"
}

Antwort

{
  "data": {
    "port": "8080",
    "proto": "tcp",
    "action": "allow",
    "source": "any",
    "success": true
  }
}

Fehler

Status Code Beschreibung
400 INVALID_PORT Port muss ein nicht-leerer String sein
400 INVALID_PROTO Protokoll muss tcp, udp oder both sein
400 INVALID_ACTION Aktion muss allow oder deny sein
400 INVALID_BODY Der Anfragekörper ist kein gültiges JSON
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
502 FIREWALL_ERROR Firewall-Operation auf dem Server fehlgeschlagen

Beispiel

curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/firewall" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"port": "8080", "proto": "tcp", "action": "allow"}'

MCP

Firewall-Verwaltung ist auch über das manage_firewall MCP-Tool verfügbar.

Firewall-Regel entfernen

Entfernt eine Firewall-Regel von einem VPS.

Die ruleId hat das Format port-proto-action (z.B. 80-tcp-allow). Für Portbereiche das vollständige Format verwenden (z.B. 8000:8100-tcp-allow).

Erforderlicher Scope: vps:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID
ruleId string Regelbezeichner im Format port-proto-action

Abfrageparameter

Parameter Typ Erforderlich Beschreibung
source string Nein Quell-IP der Regel (Standard: any)

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "port": "8080",
    "proto": "tcp",
    "action": "allow",
    "source": "any",
    "success": true
  }
}

Fehler

Status Code Beschreibung
400 INVALID_RULE_ID Regel-ID-Format ist ungültig
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
502 FIREWALL_ERROR Firewall-Operation auf dem Server fehlgeschlagen

Beispiel

curl -X DELETE "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/firewall/8080-tcp-allow" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL"

MCP

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

Firewall umschalten

Aktiviere oder deaktiviere die Firewall eines VPS.

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
enabled boolean Ja true zum Aktivieren, false zum Deaktivieren
{
  "enabled": true
}

Antwort

{
  "data": {
    "enabled": true,
    "success": true
  }
}

Fehler

Status Code Beschreibung
400 INVALID_BODY Der Anfragekörper ist kein gültiges JSON
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
502 FIREWALL_ERROR Firewall-Operation auf dem Server fehlgeschlagen

Beispiel

curl -X PUT "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/firewall" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}'

MCP

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