Befehl ausführen

Einmaligen Shell-Befehl als unprivilegierter System-User (ws_<slug>) ausführen. CWD = ~/. Cgroup-Limits greifen.

Erforderlicher Scope: webspace:manage

Header

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

Body

Parameter	Erforderlich	Beschreibung
`command`	Ja	Shell-Befehl (max. 8192 Zeichen).
`timeout`	Nein	Timeout in Sekunden (1–300, Standard 30).

Antwort

{
  "data": {
    "exitCode": 0,
    "stdout": "Linux node-bf015 6.6.20-cloud-amd64 ...\n",
    "stderr": "",
    "durationMs": 142,
    "truncated": false
  }
}

Antwortfelder

Feld	Typ	Beschreibung
`truncated`	boolean	`true`, wenn stdout/stderr bei 2 MB abgeschnitten wurde.

Fehler

Status	Code	Beschreibung
400	`INVALID_COMMAND`	`command` fehlt oder ist kein String.
400	`COMMAND_TOO_LONG`	Befehl überschreitet 8192 Zeichen.
408	`COMMAND_TIMEOUT`	Befehl hat das Timeout überschritten.
502	`SSH_CONN_ERROR`	Verbindung zum Webspace-Node fehlgeschlagen.

Beispiel

curl -X POST https://hosting.site.quest/api/v1/webspaces/69e80ac1.../exec \
  -H "Authorization: Bearer sq_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "command": "ls -la public_html", "timeout": 10 }'

MCP

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