Sandbox processes
Get a process
Get a process by ULID or name.
Get a process by ULID or name.
Authorization
apiKey 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
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/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"}{ "$schema": "https://api-dev.tektona.ai/schemas/ErrorModel.json", "detail": "Property foo is required but is missing.", "errors": [ { "location": "string", "message": "string", "value": null } ], "instance": "https://example.com/error-log/abc123", "status": 400, "title": "Bad Request", "type": "https://example.com/errors/example"}Fetch process logs GET
Fetch a process's buffered logs. 409 logging_disabled when the process ran with max_log_bytes=0.
List processes GET
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.