GET
Mint a desktop watch ticket for a session (BMA extension)

Authorizations

x-api-key
string
header
required

BMA organization API key.

Headers

x-bma-project-id
string

Project to operate in. Required when the key can read more than one project and the deployment has no default project. anthropic-workspace-id is accepted as an alias.

Path Parameters

session_id
string
required
Minimum string length: 1

Query Parameters

desktop_session_id
string
required
Minimum string length: 1
ttl_seconds
integer

Ticket lifetime. Omit for the native default.

Required range: 15 <= x <= 120
origin
string

Browser origin the ticket is bound to. Defaults to the request Origin header.

Response

Desktop watch ticket.

type
string
required
Allowed value: "bma.desktop_stream"
session_id
string
required
desktop_session_id
string
required
machine_id
string
required
url
string
required

WebSocket endpoint the ticket belongs to.

ticket
string
required

Single-use credential. Treat as a secret.

subprotocol
string
required
expires_at
string<date-time>
required
permissions
string[]
required