POST
Mint a terminal connection ticket

Authorizations

Authorization
string
header
required

An opaque BMA personal or organization bearer token.

Path Parameters

orgID
string
required

Organization ID (org_...).

Pattern: ^org_[a-z2-7]{26}$
projectID
string
required

Project ID (proj_...).

Pattern: ^proj_[a-z2-7]{26}$
machineID
string
required

Machine ID (mch_...).

Pattern: ^mch_[a-z2-7]{26}$
terminalSessionID
string
required

Terminal session ID (tsn_...).

Pattern: ^tsn_[a-z2-7]{26}$

Body

application/json
ttl_seconds
integer<int32>
Required range: 15 <= x <= 120

Response

Connection ticket.

id
string
required

Connection ticket ID (tkt_...).

Pattern: ^tkt_[a-z2-7]{26}$
ticket
string
required

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

purpose
enum<string>
required
Available options:
terminal_connect,
desktop_watch
expires_at
string<date-time>
required
ws_url
string
required

WebSocket URL without the ticket.

subprotocol
string
required
permissions
string[]
required