Skip to main content
DELETE
Stops the screen’s X server, its window manager, and every window on it. This is not recoverable. The display number the screen was using is freed, and the next screen you create takes it.
The boot screen (default) cannot be destroyed. A computer with no screen is a computer nobody can see, so the request is refused with 409.

​
Path parameters

​
string
required
Computer ID (UUID). The computer must be up. One that is still being created, or that has been frozen, returns 400.
​
string
required
Screen ID. Must not be default.

​
Response

204 No Content with an empty body. There is nothing left to describe once the screen is gone.

​
Errors

Failures raised before the request reaches the computer carry error alone. Failures relayed back from the computer add request_id and upstream_status. This differs from get: a screen ID that does not exist answers 409 here, not 404. Destroying the boot screen and destroying a screen that was never there are both refusals. Both come back as 409, and the message tells them apart.

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.

Response

Screen destroyed. The response has no body.