Datei löschen

Datei oder Verzeichnis im Webspace-Home löschen. Das Home selbst kann nicht gelöscht werden.

Erforderlicher Scope: webspace:manage

Header

Header	Erforderlich	Wert
`Authorization`	Ja	`Bearer DEIN_API_SCHLÜSSEL`
`Content-Type`	Ja	`application/json`

Body

Parameter	Erforderlich	Beschreibung
`path`	Ja	Absoluter Pfad innerhalb `~/`.
`recursive`	Nein	Bei `true` werden Verzeichnisse rekursiv gelöscht (`rm -rf`).

Antwort

{ "data": { "path": "/home/ws_0862c/old", "deleted": true, "recursive": true } }

Fehler

Status	Code	Beschreibung
403	`HOME_DIR_PROTECTED`	Webspace-Home kann nicht gelöscht werden.

Beispiel

curl -X DELETE https://hosting.site.quest/api/v1/webspaces/69e80ac1.../sftp/delete \
  -H "Authorization: Bearer sq_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "path": "/home/ws_0862c/old", "recursive": true }'

MCP

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