Open an interactive WebSocket terminal session.

Upgrades the connection to a WebSocket for bidirectional PTY I/O. Accepts access_token query param for browser-based auth (WebSocket API cannot send custom headers). Streams raw PTY output as binary frames and accepts JSON control frames for input, resize, and close.

GET /v1/processes/{id}/terminal/ws

Open an interactive WebSocket terminal session.

cURL

curl --request GET \
  --url http://localhost:2468/v1/processes/{id}/terminal/ws

400

{
  "status": 1,
  "title": "<string>",
  "type": "<string>",
  "detail": "<string>",
  "instance": "<string>"
}

Path Parameters

id · string · required

Process ID

Query Parameters

access_token · string | null

Bearer token alternative for WS auth

Response

101

WebSocket upgraded