POST
Hand control back

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}$
desktopSessionID
string
required

Desktop session ID (dsn_...).

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

Response

Updated desktop control state.

mode
enum<string>
required
Available options:
paused,
agent,
human
epoch
integer<int64>
required
generation
integer<int64>
required
holder
string
required
agent_state
string
required
lease_id
string
lease_expires_at
string<date-time>