Skip to main content
PATCH
Resizes a screen in place. Windows already open on it are kept.

​
Path parameters

​
string
required
Computer ID (UUID).
​
string
required
Screen ID, or default for the boot screen.

​
Body parameters

​
integer
required
New width in pixels.
​
integer
required
New height in pixels.
Both are required here, unlike create — there is no boot screen to fall back to when the intent is an explicit change.

Authorizations

​
Authorization
string
header
required

API key authentication. Get your key at orgo.ai/workspaces

Path Parameters

​
id
string
required

Computer ID

​
screenId
string
required

Screen ID, or default for the boot screen.

Body

application/json
​
width
integer

Width in pixels. Defaults to the size of the boot screen.

Example:

1920

​
height
integer

Height in pixels. Defaults to the size of the boot screen.

Example:

1080

Response

The resized screen

​
id
string

Screen identifier. The boot screen is always default.

Example:

"screen-1"

​
display
string

X display this screen runs on.

Example:

":100"

​
width
integer

Width in pixels.

Example:

1920

​
height
integer

Height in pixels.

Example:

1080

​
vnc_port
integer

VNC port for this screen.

Example:

6000

​
ws_port
integer

WebSocket port for this screen.

Example:

6081

​
default
boolean

True for the screen the computer boots with. It cannot be destroyed.

Example:

false