Skip to main content
POST
Mint a Computer Screen viewer grant

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}$
screen_id
string
required
Pattern: ^scrn_[0-9a-f]{32}$

Body

application/json
port
integer
required
Required range: 1 <= x <= 65535
mode
enum<string>
required
Available options:
readonly,
takeover
origin
string
required
Required string length: 8 - 253
Pattern: ^https:\/\/[a-z0-9][a-z0-9.-]*[a-z0-9](?::[0-9]{1,5})?$
requested_at
string
required

A canonical UTC ISO-8601 timestamp with millisecond precision.

Maximum string length: 24
Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$
expires_at
string
required

A canonical UTC ISO-8601 timestamp with millisecond precision.

Maximum string length: 24
Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$

Response

Success

id
string
required
Pattern: ^cing_[0-9a-f]{32}$
computer_id
string
required
Pattern: ^comp_[0-9a-f]{32}$
screen_id
string
required
Pattern: ^scrn_[0-9a-f]{32}$
port
integer
required
Required range: 1 <= x <= 65535
mode
enum<string>
required
Available options:
readonly,
takeover
origin
string
required
Required string length: 8 - 253
Pattern: ^https:\/\/[a-z0-9][a-z0-9.-]*[a-z0-9](?::[0-9]{1,5})?$
expires_at
string
required

A canonical UTC ISO-8601 timestamp with millisecond precision.

Maximum string length: 24
Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$
token
string
required
Pattern: ^[0-9a-f]{64}$