POST
Mint a single-use ticket (purpose connect)

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).

Idempotency-Key
string

Replays the first result of a create; the same key with another body is 409.

Required string length: 1 - 255

Path Parameters

terminal_session_id
string
required

Body

application/json

Body of a terminal ticket. purpose is optional and must be connect.

purpose
enum<string>
Available options:
connect
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