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.