Skip to navigation
Workspace APIPlaybooks

Mint a live WebSocket ticket for a run

View as Markdown

Mints a short-lived ticket for opening the run’s live WebSocket, used to stream timeline events in real time (the WS upgrade itself is not exposed over this API / MCP surface). Authorization: space:read (org admins bypass); missing → 404. No request body. The ticket carries a capability view — “full” when the caller has space:contribute, otherwise “sanitized” (artifact URLs redacted on the stream). Returns 200 { ticket, expiresAt }.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired
runIdstringRequired

Response

A ticket and its expiry for the run WebSocket.
ticketstring

Single-use and short-lived.

expiresAtdatetime