POST
Mint a single-use ticket (purpose watch)

Authorizations

x-api-key
string
header
required

Headers

x-bma-project-id
string

Project scope. Required when the API key can access more than one project (alias: anthropic-workspace-id).

Path Parameters

desktop_session_id
string
required

Body

application/json

Body of a desktop ticket. purpose is optional and must be watch.

purpose
enum<string>
Available options:
watch
origin
string
ttl_seconds
integer
Required range: 15 <= x <= 120

Response

Success.

A single-use ticket (D-7). purpose names what it opens (watch, connect; control is reserved).

ticket
string
required

Opaque single-use ticket. Returned once and never logged.

ws_url
string
required

WebSocket URL without the ticket.

type
any
required
purpose
enum<string>
required
Available options:
watch,
connect,
control
id
string
expires_at
string<date-time>
subprotocol
string
permissions
string[]
machine_id
string
desktop_session_id
string