Sandbox processes

Mint a process stream token

Mint a short-lived, mode-scoped token and return the complete access-gateway wss:// URL for log tailing (logs) or interactive attach (attach).

PUT
/v1/sandboxes/{sandboxId}/processes/{ref}/stream-access

Mint a short-lived, mode-scoped token and return the complete access-gateway wss:// URL for log tailing (logs) or interactive attach (attach).

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

mode*string

logs (read-only) or attach (read-write)

Value in"logs" | "attach"

Response Body

application/json

application/problem+json

curl -X PUT "https://api-dev.tektona.ai/v1/sandboxes/string/processes/string/stream-access" \  -H "Content-Type: application/json" \  -d '{    "mode": "logs"  }'
{  "$schema": "https://api-dev.tektona.ai/schemas/StreamAccessResponseDTO.json",  "expires_at": "2019-08-24T14:15:22Z",  "token": "string",  "url": "string"}