API-Dokumentation

VPS-API: SSH, Befehle und Dateien

Befehle ausführen, SSH-Schlüssel und SSH-Sicherheit verwalten und Dateien per SFTP lesen, schreiben und organisieren, über die Sitequest REST-API.

SSH-Befehl ausführen

Führe einen einmaligen SSH-Befehl auf einem VPS aus und erhalte stdout, stderr und den Exit-Code.

Erforderlicher Scope: vps:exec

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
command string Ja Shell-Befehl (max. 8192 Zeichen)
timeout number Nein Timeout in Sekunden (1–300, Standard 30)
{
  "command": "uptime",
  "timeout": 10
}

Antwort

{
  "data": {
    "exitCode": 0,
    "stdout": " 14:32:01 up 12 days,  3:45,  0 users,  load average: 0.00, 0.01, 0.05\n",
    "stderr": "",
    "durationMs": 142
  }
}

Antwortfelder

Feld Typ Beschreibung
exitCode number Der Exit-Code des Befehls (0 = Erfolg)
stdout string Standardausgabe
stderr string Standardfehlerausgabe
durationMs number Ausführungszeit in Millisekunden

Fehler

Status Code Beschreibung
400 INVALID_COMMAND Befehl fehlt oder ist kein String
400 COMMAND_TOO_LONG Befehl überschreitet 8192 Zeichen
400 INVALID_TIMEOUT Timeout ausserhalb des Bereichs (1–300)
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
408 COMMAND_TIMEOUT Befehl hat das Zeitlimit überschritten
502 SSH_AUTH_ERROR SSH-Authentifizierung fehlgeschlagen
502 SSH_CONNECTION_ERROR Verbindung zum VPS nicht möglich

Beispiel

curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/exec" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"command": "uptime", "timeout": 10}'

MCP

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

SSH-Sicherheitsstatus abrufen

Gibt die SSH-Sicherheitseinstellungen eines VPS zurück, einschließlich Passwort-Authentifizierung, HMAC-Algorithmen, Banner-Sichtbarkeit, Post-Quanten-Schlüsselaustausch und Legacy-Cipher-Status.

Erforderlicher Scope: vps:read

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "passwordAuth": true,
    "sha1HmacEnabled": false,
    "bannerHidden": true,
    "bannerSupported": true,
    "postQuantumKexEnabled": true,
    "legacyCiphersEnabled": false,
    "postQuantumSupported": true,
    "opensshVersion": "9.2p1",
    "opensshPackageVersion": "1:9.2p1-2+deb12u3",
    "opensshLatestAvailable": "1:9.2p1-2+deb12u3",
    "updateAvailable": false,
    "readViaSSH": true
  }
}

Antwortfelder

Feld Typ Beschreibung
passwordAuth boolean Ob Passwort-Authentifizierung aktiviert ist
sha1HmacEnabled boolean Ob SHA-1-basierte HMAC-Algorithmen aktiviert sind
bannerHidden boolean Ob das SSH-Versionsbanner ausgeblendet ist
bannerSupported boolean Ob das Ausblenden des Banners auf diesem OS unterstützt wird
postQuantumKexEnabled boolean Ob Post-Quanten-Schlüsselaustausch aktiviert ist
legacyCiphersEnabled boolean Ob Legacy-Chiffren (CBC/3DES) erlaubt sind
postQuantumSupported boolean Ob das installierte OpenSSH Post-Quanten-KEX unterstützt
opensshVersion string Installierte OpenSSH-Version
opensshPackageVersion string Installierte Paketversion
opensshLatestAvailable string Neueste verfügbare Paketversion
updateAvailable boolean Ob ein Update verfügbar ist
readViaSSH boolean Ob der Status über SSH gelesen wurde (false = Standardwerte/unbekannt)

Fehler

Status Code Beschreibung
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff

Beispiel

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

MCP

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

SSH-Sicherheitseinstellung ändern

Aktualisiert eine SSH-Sicherheitseinstellung auf einem VPS. Jede Anfrage ändert genau eine Einstellung.

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

Body

Feld Typ Erforderlich Beschreibung
setting string Ja Die zu ändernde Einstellung
enabled boolean Ja Ob die Einstellung aktiviert/deaktiviert werden soll
useHypervisor boolean Nein Hypervisor-Bypass verwenden (siehe unten)

Verfügbare Einstellungen

Setting Beschreibung
passwordAuth Passwort-Authentifizierung aktivieren/deaktivieren
sha1Hmac SHA-1-basierte HMAC-Algorithmen aktivieren/deaktivieren
hideBanner SSH-Versionsbanner ausblenden/anzeigen
postQuantumKex Post-Quanten-Schlüsselaustausch aktivieren/deaktivieren
legacyCiphers Legacy-Chiffren (CBC/3DES) erlauben/verbieten

Hypervisor-Bypass

Wenn SSH-Zugang nicht möglich ist (z.B. nach Aussperren durch Deaktivieren der Passwort-Auth ohne hinterlegten SSH-Schlüssel), kann useHypervisor: true gesetzt werden. Der Server führt den Befehl dann über den Hypervisor aus, statt eine SSH-Verbindung zu nutzen.

Hinweis: Hypervisor-Befehle können etwas länger dauern.

Antwort

{
  "data": {
    "message": "SSH security setting updated",
    "setting": "passwordAuth",
    "enabled": false
  }
}

Fehler

Status Code Beschreibung
400 BAD_REQUEST Ungültiger Einstellungsname oder Wert
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
500 INTERNAL_ERROR SSH-Befehl fehlgeschlagen — Details in der Fehlermeldung

Beispiel

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

MCP

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

SSH-Schlüssel auflisten

Gibt alle auf einem VPS hinterlegten SSH-Schlüssel zurück, einschließlich Schlüssel-IDs, Anzeigenamen, Erstellungsdaten und öffentlicher Schlüssel.

Erforderlicher Scope: vps:read

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": [
    {
      "keyId": "abc123",
      "displayName": "mein-schlüssel",
      "createDate": "2026-04-10T12:00:00Z",
      "publicKey": "ssh-ed25519 AAAAC3NzaC1..."
    }
  ]
}

Antwortfelder

Feld Typ Beschreibung
keyId string Eindeutiger Bezeichner des Schlüssels
displayName string Anzeigename des Schlüssels
createDate string ISO-8601-Erstellungszeitstempel
publicKey string Der öffentliche Schlüssel im OpenSSH-Format

Fehler

Status Code Beschreibung
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff

Beispiel

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

MCP

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

SSH-Schlüssel generieren

Generiert ein neues SSH-Schlüsselpaar auf einem VPS. Der öffentliche Schlüssel wird in der Antwort zurückgegeben. Optional kann der Schlüssel für den Web-Terminal-Zugang gespeichert werden.

Erforderlicher Scope: vps:exec

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

Body

Feld Typ Erforderlich Beschreibung
action string Ja Muss "generate" sein
displayName string Nein Anzeigename für den Schlüssel
useForWebTerminal boolean Nein Schlüssel für Web-Terminal-Zugang speichern (Standard: false)

Antwort

{
  "data": {
    "keyId": "abc123",
    "displayName": "mein-schlüssel",
    "publicKey": "ssh-ed25519 AAAAC3NzaC1...",
    "webTerminalKeyId": "abc123"
  }
}

Antwortfelder

Feld Typ Beschreibung
keyId string Eindeutiger Bezeichner des generierten Schlüssels
displayName string Anzeigename des Schlüssels
publicKey string Der generierte öffentliche Schlüssel im OpenSSH-Format
webTerminalKeyId string | null Die Schlüssel-ID, falls für das Web-Terminal gespeichert, sonst null

Fehler

Status Code Beschreibung
400 INVALID_ACTION action muss "generate" oder "upload" sein
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
502 PROVIDER_ERROR Schlüsselgenerierung beim Provider fehlgeschlagen

Beispiel

curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/ssh/keys" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "displayName": "mein-schlüssel", "useForWebTerminal": true}'

MCP

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

SSH-Schlüssel hochladen

Lädt einen vorhandenen öffentlichen SSH-Schlüssel auf einen VPS hoch. Optional kann die Schlüssel-ID für den Web-Terminal-Zugang gespeichert werden.

Erforderlicher Scope: vps:exec

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

Body

Feld Typ Erforderlich Beschreibung
action string Ja Muss "upload" sein
publicKey string Ja Der öffentliche SSH-Schlüssel (muss mit ssh- beginnen)
displayName string Nein Anzeigename für den Schlüssel
useForWebTerminal boolean Nein Schlüssel-ID für Web-Terminal-Zugang speichern (Standard: false)

Antwort

{
  "data": {
    "keyId": "abc123",
    "displayName": "mein-schlüssel",
    "publicKey": "ssh-ed25519 AAAAC3NzaC1...",
    "webTerminalKeyId": null
  }
}

Antwortfelder

Feld Typ Beschreibung
keyId string Eindeutiger Bezeichner des hochgeladenen Schlüssels
displayName string Anzeigename des Schlüssels
publicKey string Der hochgeladene öffentliche Schlüssel
webTerminalKeyId string | null Die Schlüssel-ID, falls für das Web-Terminal gespeichert, sonst null

Hinweis: Das Hochladen eines öffentlichen Schlüssels für den Web-Terminal-Zugang speichert nur die Schlüssel-ID. Das Web-Terminal benötigt weiterhin einen gespeicherten privaten Schlüssel (aus einer vorherigen Generierung oder dem Rescue-Flow), um eine Verbindung herzustellen.

Fehler

Status Code Beschreibung
400 INVALID_ACTION action muss "generate" oder "upload" sein
400 MISSING_PUBLIC_KEY publicKey ist für den Upload erforderlich
400 INVALID_PUBLIC_KEY Öffentlicher Schlüssel muss mit ssh- beginnen
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
502 PROVIDER_ERROR Schlüssel-Upload beim Provider fehlgeschlagen

Beispiel

curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/ssh/keys" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"action": "upload", "publicKey": "ssh-ed25519 AAAAC3NzaC1...", "displayName": "mein-laptop"}'

MCP

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

SSH-Schlüssel löschen

Löscht einen SSH-Schlüssel von einem VPS. Wenn der gelöschte Schlüssel der aktive Web-Terminal-Schlüssel war, wird die Terminal-Schlüssel-Einstellung zurückgesetzt.

Erforderlicher Scope: vps:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID
keyId string Die ID des zu löschenden SSH-Schlüssels

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "keyId": "abc123",
    "deleted": true
  }
}

Fehler

Status Code Beschreibung
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
502 PROVIDER_ERROR Schlüssel-Löschung beim Provider fehlgeschlagen

Beispiel

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

MCP

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

SFTP-Verzeichnis auflisten

Verzeichnisinhalte auf einem VPS auflisten. Gibt Dateinamen, Typen, Größen und Änderungszeiten zurück.

Erforderlicher Scope: vps:files

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Abfrageparameter

Parameter Typ Erforderlich Beschreibung
path string Ja Absoluter Pfad des aufzulistenden Verzeichnisses

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "path": "/var/log",
    "entries": [
      {
        "name": "syslog",
        "isDirectory": false,
        "isSymlink": false,
        "size": 524288,
        "mode": "0644",
        "modifiedAt": "2025-01-15T10:30:00.000Z"
      },
      {
        "name": "nginx",
        "isDirectory": true,
        "isSymlink": false,
        "size": 4096,
        "mode": "0755",
        "modifiedAt": "2025-01-14T08:00:00.000Z"
      }
    ]
  }
}

Antwortfelder

Feld Typ Beschreibung
path string Aufgelöster absoluter Pfad
entries array Liste der Verzeichniseinträge
entries[].name string Datei- oder Verzeichnisname
entries[].isDirectory boolean Ob der Eintrag ein Verzeichnis ist
entries[].isSymlink boolean Ob der Eintrag ein symbolischer Link ist
entries[].size number Größe in Bytes
entries[].mode string Berechtigungen als vierstellige Oktalzahl
entries[].modifiedAt string Letzter Änderungszeitpunkt (ISO 8601)

Fehler

Status Code Beschreibung
400 VALIDATION path fehlt, ist nicht absolut oder ungültig
403 FORBIDDEN Kein Inhaber-Zugriff auf den VPS
404 NOT_FOUND VPS oder Pfad nicht gefunden
502 PROVIDER Verbindung oder SFTP-Vorgang fehlgeschlagen

Beispiel

curl "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/sftp/list?path=/var/log" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL"

MCP

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

SFTP-Datei lesen

Dateiinhalt von einem VPS lesen. Unterstützt Text- (utf8) und Binär-Kodierung (base64). Maximale Dateigröße ist 32 MB.

Erforderlicher Scope: vps:files

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Abfrageparameter

Parameter Typ Erforderlich Beschreibung
path string Ja Absoluter Pfad der zu lesenden Datei
encoding string Nein utf8 (Standard) oder base64

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "path": "/etc/nginx/nginx.conf",
    "content": "worker_processes auto;\nevents { ... }\n",
    "encoding": "utf8",
    "size": 1024
  }
}

Antwortfelder

Feld Typ Beschreibung
path string Normalisierter absoluter Pfad
content string Dateiinhalt in der angeforderten Kodierung
encoding string Die verwendete Kodierung (utf8 oder base64)
size number Dateigröße in Bytes

Fehler

Status Code Beschreibung
400 MISSING_PATH Der path-Abfrageparameter fehlt
400 INVALID_PATH Pfad ist nicht absolut
400 INVALID_ENCODING Kodierung ist nicht utf8 oder base64
400 READ_ERROR Datei konnte nicht gelesen werden
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
404 FILE_NOT_FOUND Datei existiert nicht
408 TIMEOUT Lesen der Datei hat das Zeitlimit überschritten
413 FILE_TOO_LARGE Datei überschreitet 32 MB
502 SSH_AUTH_ERROR SSH-Authentifizierung fehlgeschlagen
502 SSH_CONNECTION_ERROR Verbindung zum VPS nicht möglich

Beispiel

curl "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/sftp/read?path=/etc/hostname" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL"

MCP

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

SFTP-Datei schreiben

Inhalt in eine Datei auf einem VPS schreiben. Übergeordnete Verzeichnisse werden automatisch erstellt. Unterstützt Text- (utf8) und Binär-Kodierung (base64). Maximale Inhaltsgröße ist 32 MB.

Erforderlicher Scope: vps:exec

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
path string Ja Absoluter Pfad der zu schreibenden Datei
content string Ja Der Dateiinhalt
encoding string Nein utf8 (Standard) oder base64 für Binärdateien
{
  "path": "/etc/motd",
  "content": "Willkommen auf meinem Server!\n"
}

Antwort

{
  "data": {
    "path": "/etc/motd",
    "size": 30
  }
}

Antwortfelder

Feld Typ Beschreibung
path string Normalisierter absoluter Pfad der geschriebenen Datei
size number Dateigröße in Bytes nach dem Schreiben

Fehler

Status Code Beschreibung
400 INVALID_BODY Anfragekörper ist kein gültiges JSON
400 MISSING_PATH Pfad fehlt oder ist kein String
400 INVALID_PATH Pfad ist nicht absolut
400 MISSING_CONTENT Inhalt fehlt oder ist kein String
400 INVALID_ENCODING Kodierung ist nicht utf8 oder base64
400 WRITE_ERROR Datei konnte nicht geschrieben werden
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
408 TIMEOUT Schreiben der Datei hat das Zeitlimit überschritten
413 CONTENT_TOO_LARGE Inhalt überschreitet 32 MB
502 SSH_AUTH_ERROR SSH-Authentifizierung fehlgeschlagen
502 SSH_CONNECTION_ERROR Verbindung zum VPS nicht möglich

Beispiel

curl -X PUT "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/sftp/write" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"path": "/etc/motd", "content": "Willkommen auf meinem Server!\n"}'

MCP

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

SFTP-Datei oder -Verzeichnis löschen

Eine Datei oder ein Verzeichnis auf einem VPS löschen. Standardmäßig werden nur Dateien und leere Verzeichnisse entfernt; mit recursive: true werden Verzeichnisse samt Inhalt gelöscht. Einige Systemwurzeln (/, /usr, /etc, /var, /home) werden grundsätzlich abgelehnt.

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
path string Ja Absoluter Pfad der zu löschenden Datei oder des Verzeichnisses
recursive boolean Nein Bei true Verzeichnis samt Inhalt löschen (Standard: false)
{
  "path": "/tmp/build-cache",
  "recursive": true
}

Antwort

{
  "data": {
    "path": "/tmp/build-cache",
    "deleted": true,
    "recursive": true
  }
}

Antwortfelder

Feld Typ Beschreibung
path string Normalisierter absoluter Pfad, der gelöscht wurde
deleted boolean Bei Erfolg immer true
recursive boolean Ob der rekursive Modus verwendet wurde

Fehler

Status Code Beschreibung
400 INVALID_BODY Anfragekörper ist kein gültiges JSON
400 INVALID_PATH Pfad ist nicht absolut oder ein geschütztes Wurzelverzeichnis
400 DELETE_FAILED Allgemeiner Löschfehler
403 DELETE_FAILED Keine Berechtigung für den Zielpfad
404 NOT_FOUND VPS nicht gefunden, kein Zugriff oder Pfad existiert nicht
409 DELETE_FAILED Verzeichnis ist nicht leer (mit recursive: true erneut versuchen)
502 SSH_AUTH SSH-Authentifizierung fehlgeschlagen
502 SSH_CONN Verbindung zum VPS nicht möglich
504 SSH_TIMEOUT SSH-Befehl hat das Zeitlimit überschritten

Beispiel

curl -X DELETE "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/sftp/delete" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"path": "/tmp/build-cache", "recursive": true}'

MCP

Dieser Endpunkt ist noch nicht als MCP-Tool verfügbar. Den obigen REST-Endpunkt direkt nutzen.

SFTP umbenennen oder verschieben

Eine Datei oder ein Verzeichnis auf einem VPS umbenennen oder verschieben. Das Ziel darf nicht bereits existieren; vorhandene Dateien werden nicht überschrieben.

Erforderlicher Scope: vps:exec

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
from string Ja Absoluter Quellpfad
to string Ja Absoluter Zielpfad
{
  "from": "/var/www/alt.html",
  "to":   "/var/www/neu.html"
}

Antwort

{
  "data": {
    "from": "/var/www/alt.html",
    "to":   "/var/www/neu.html",
    "renamed": true
  }
}

Antwortfelder

Feld Typ Beschreibung
from string Normalisierter Quellpfad
to string Normalisierter Zielpfad
renamed boolean Bei Erfolg immer true

Fehler

Status Code Beschreibung
400 INVALID_BODY Anfragekörper ist kein gültiges JSON
400 INVALID_FROM from ist kein absoluter Pfad
400 INVALID_TO to ist kein absoluter Pfad
400 RENAME_FAILED Allgemeiner Umbenennungsfehler
403 RENAME_FAILED Keine Berechtigung
404 NOT_FOUND VPS nicht gefunden, kein Zugriff oder Quellpfad existiert nicht
409 RENAME_FAILED Ziel existiert bereits
502 SSH_AUTH SSH-Authentifizierung fehlgeschlagen
502 SSH_CONN Verbindung zum VPS nicht möglich
504 SSH_TIMEOUT SSH-Befehl hat das Zeitlimit überschritten

Beispiel

curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/sftp/rename" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"from": "/var/www/alt.html", "to": "/var/www/neu.html"}'

MCP

Dieser Endpunkt ist noch nicht als MCP-Tool verfügbar. Den obigen REST-Endpunkt direkt nutzen.

SFTP Verzeichnis anlegen

Ein Verzeichnis auf einem VPS erstellen. Standardmäßig werden übergeordnete Verzeichnisse bei Bedarf miterstellt (mkdir -p); mit recursive: false muss das übergeordnete Verzeichnis bereits existieren.

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
path string Ja Absoluter Pfad des zu erstellenden Verzeichnisses
recursive boolean Nein Übergeordnete Verzeichnisse bei Bedarf anlegen (Standard: true)
{
  "path": "/var/www/uploads/2026"
}

Antwort

{
  "data": {
    "path": "/var/www/uploads/2026",
    "created": true,
    "recursive": true
  }
}

Antwortfelder

Feld Typ Beschreibung
path string Normalisierter absoluter Pfad, der erstellt wurde
created boolean Bei Erfolg immer true
recursive boolean Ob übergeordnete Verzeichnisse automatisch erstellt wurden

Fehler

Status Code Beschreibung
400 INVALID_BODY Anfragekörper ist kein gültiges JSON
400 INVALID_PATH Pfad ist nicht absolut
400 MKDIR_FAILED Allgemeiner mkdir-Fehler
403 MKDIR_FAILED Keine Berechtigung
404 MKDIR_FAILED Übergeordnetes Verzeichnis existiert nicht (nur nicht-rekursiv)
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
409 MKDIR_FAILED Verzeichnis existiert bereits (nur nicht-rekursiv)
502 SSH_AUTH SSH-Authentifizierung fehlgeschlagen
502 SSH_CONN Verbindung zum VPS nicht möglich
504 SSH_TIMEOUT SSH-Befehl hat das Zeitlimit überschritten

Beispiel

curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/sftp/mkdir" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"path": "/var/www/uploads/2026"}'

MCP

Dieser Endpunkt ist noch nicht als MCP-Tool verfügbar. Den obigen REST-Endpunkt direkt nutzen.

SFTP Berechtigungen ändern

Unix-Berechtigungen einer Datei oder eines Verzeichnisses auf einem VPS ändern. Der Modus kann als oktaler String (z. B. "0755", "644") oder als Dezimalzahl im Bereich 0–4095 angegeben werden.

Erforderlicher Scope: vps:exec

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
path string Ja Absoluter Pfad der Datei oder des Verzeichnisses
mode string | number Ja Oktaler String ("0755", "644") oder Dezimalzahl (0–4095)
{
  "path": "/var/www/html/script.sh",
  "mode": "0755"
}

Antwort

{
  "data": {
    "path": "/var/www/html/script.sh",
    "mode": "0755"
  }
}

Antwortfelder

Feld Typ Beschreibung
path string Normalisierter absoluter Pfad
mode string Angewendeter Berechtigungsmodus als 3- oder 4-stelliger oktaler String

Fehler

Status Code Beschreibung
400 INVALID_BODY Anfragekörper ist kein gültiges JSON
400 INVALID_PATH Pfad ist nicht absolut
400 INVALID_MODE Modus ist kein oktaler String oder gültige Dezimalzahl (0–4095)
400 CHMOD_FAILED Allgemeiner chmod-Fehler
403 CHMOD_FAILED Keine Berechtigung
404 CHMOD_FAILED Zielpfad existiert nicht
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
502 SSH_AUTH SSH-Authentifizierung fehlgeschlagen
502 SSH_CONN Verbindung zum VPS nicht möglich
504 SSH_TIMEOUT SSH-Befehl hat das Zeitlimit überschritten

Beispiel

curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/sftp/chmod" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"path": "/var/www/html/script.sh", "mode": "0755"}'

MCP

Dieser Endpunkt ist noch nicht als MCP-Tool verfügbar. Den obigen REST-Endpunkt direkt nutzen.