API-Dokumentation

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 10 MB.

Anfrage

PUT /api/v1/vps/{id}/sftp/write

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 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 10 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.