Verzeichnis auflisten

Verzeichnisinhalt unterhalb des Webspace-Homes (~/) auflisten. Alle Pfade werden gegen die Jail-Root validiert.

Erforderlicher Scope: webspace:manage

Header

Header	Erforderlich	Wert
`Authorization`	Ja	`Bearer DEIN_API_SCHLÜSSEL`

Query-Parameter

Parameter	Erforderlich	Beschreibung
`path`	Ja	Absoluter Pfad innerhalb `~/` (z. B. `/home/ws_xxx/public_html`).

Antwort

{
  "data": {
    "path": "/home/ws_0862c/public_html",
    "entries": [
      { "name": "index.html", "isDirectory": false, "size": 256, "modifiedAt": "2026-04-22T12:34:56+0000" },
      { "name": "assets",     "isDirectory": true,  "size": 4096, "modifiedAt": "2026-04-22T12:30:00+0000" }
    ]
  }
}

Fehler

Status	Code	Beschreibung
400	`PATH_OUTSIDE_JAIL`	Pfad verlässt das Webspace-Home.

Beispiel

curl "https://hosting.site.quest/api/v1/webspaces/69e80ac1.../sftp/list?path=/home/ws_0862c/public_html" \
  -H "Authorization: Bearer sq_live_..."

MCP

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