Cancel a command
Stops a running command (SIGTERM, then SIGKILL after 5 seconds) and returns it. A finished command is returned unchanged. Requires run_commands. Commands and file operations need an ACTIVE sandbox; on any other state they answer 409.
Authorizations
workspace API token (sk_akua_...) or OAuth2 JWT. Create tokens at https://akua.dev/developers/api-tokens
Headers
Optional workspace/scope context for the request. Carries a single workspace wire id (ws_…) today. Only needed for broad tokens - a workspace-owned token implies its workspace.
1 - 53"ws_j572abc123def456"
Path Parameters
Sandbox id (sbx_...).
^sbx_[A-Za-z0-9]{1,64}$"sbx_j572abc123def456"
Sandbox command id (cmd_...).
^cmd_[A-Za-z0-9]{1,64}$"cmd_j572abc123def456"
Response
SandboxCommand
Sandbox command id (cmd_...).
^cmd_[A-Za-z0-9]{1,64}$"cmd_j572abc123def456"
Sandbox id (sbx_...).
^sbx_[A-Za-z0-9]{1,64}$"sbx_j572abc123def456"
SUCCEEDED: exited with code 0. FAILED: exited with another code, was killed, or hit its timeout (exit code 124).
RUNNING, SUCCEEDED, FAILED, CANCELLED Set once the command finished.
Start time (Unix seconds).
x >= 0Finish time (Unix seconds).
x >= 0Captured output, only on the response to a wait: true request that finished in time; null elsewhere.