Sandbox processes

Stop a process

Stop a process: SIGTERM → grace → SIGKILL over the process group. force=true sends SIGKILL immediately.

DELETE
/v1/sandboxes/{sandboxId}/processes/{ref}

Stop a process: SIGTERM → grace → SIGKILL over the process group. force=true sends SIGKILL immediately.

AuthorizationBearer <token>

API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.

In: header

Path Parameters

sandboxId*string

Sandbox ID (ULID)

ref*string

Process ULID or name

Query Parameters

force?boolean

Skip graceful escalation and send SIGKILL immediately

resume?boolean

Wake a paused sandbox to serve this request

Response Body

application/json

application/problem+json

curl -X DELETE "https://api-dev.tektona.ai/v1/sandboxes/string/processes/string"
{  "$schema": "https://api-dev.tektona.ai/schemas/ProcessDTO.json",  "already_finished": true,  "autostart": true,  "command": "string",  "cwd": "string",  "error": "string",  "exit_code": 0,  "finish_reason": "string",  "finished_at": "2019-08-24T14:15:22Z",  "id": "string",  "max_log_bytes": 0,  "name": "string",  "on_hibernate": "string",  "pid": 0,  "prevent_auto_pause": true,  "restarted_from": "string",  "signal": "string",  "started_at": "2019-08-24T14:15:22Z",  "status": "running",  "stderr": "string",  "stdout": "string",  "tty": {    "cols": 0,    "enabled": true,    "rows": 0  },  "user": "string"}