Skip to main content
GET
Upgrade to the managed desktop viewer websocket bridge

Path Parameters

id
string
required

Machine ID (e.g. mch_a1b2c3d4)

Query Parameters

auth
string
required

Short-lived managed desktop viewer auth token returned by /desktop/stream/start, /desktop/stream/auth-key, or /desktop/viewer/session.

Response

WebSocket upgrade for the managed viewer bridge. The route requires the managed-session auth query token. For sessions started with view_only=true, interactive RFB client messages are filtered server-side before they reach the guest VNC socket. In edge mode the websocket bridge is edge-owned and forwards through the assigned private host-agent instead of the API-local bridge. The browser viewer page is expected to renew its session through /desktop/viewer/session before reconnecting here after a drop.