Skip to main content
POST
Open a Computer viewer

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

checkfu-version
enum<string>
required
Available options:
2026-08-31
idempotency-key
string
Maximum string length: 255

Path Parameters

id
string
required
Pattern: ^comp_[0-9a-f]{32}$

Body

application/json

Request one short-lived desktop viewer URL.

mode
enum<string>
required

view observes the desktop without input; control takes the exclusive human input lease.

Available options:
view,
control

Response

A short-lived bearer URL that opens the Computer's desktop in a browser.

A short-lived bearer URL that opens the Computer's desktop in a browser.

type
enum<string>
required
Available options:
computer_viewer_session
computer_id
string
required
Pattern: ^comp_[0-9a-f]{32}$
mode
enum<string>
required

view observes the desktop without input; control takes the exclusive human input lease.

Available options:
view,
control
url
string
required
expires_at
string
required