Sandbox processes

List processes

List a sandbox's running and finished processes together with its persisted autostart definitions. autostart=true returns only the autostart definitions; autostart=false only running and finished processes.

GET
/v1/sandboxes/{sandboxId}/processes

List a sandbox's running and finished processes together with its persisted autostart definitions. autostart=true returns only the autostart definitions; autostart=false only running and finished processes.

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)

Query Parameters

autostart?string

Filter: true = autostart definitions only, false = running/finished only; omit for all

Value in"true" | "false"
resume?boolean

Wake a paused sandbox to serve this request

Response Body

application/json

application/problem+json

curl -X GET "https://api-dev.tektona.ai/v1/sandboxes/string/processes"
{  "$schema": "https://api-dev.tektona.ai/schemas/ProcessListResponse.json",  "processes": [    {      "already_finished": true,      "autostart": true,      "command": "string",      "cwd": "string",      "enabled": true,      "error": "string",      "exit_code": 0,      "finish_reason": "string",      "finished_at": "2019-08-24T14:15:22Z",      "id": "string",      "last_instance_id": "string",      "last_launched_at": "2019-08-24T14:15:22Z",      "last_status": "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"    }  ]}