Docs
⌘K
Desktop ›

Disable desktop

DELETE/v1/sandboxes/{id}/desktop

Turns the desktop off for the sandbox. The address it was watched at leads nowhere from then on, the desktop is stopped, which closes what is open on it, and none is started for the sandbox again. It is done whatever state the sandbox is in.

RequestTypeScript
  1. import { Agental } from "agental-sdk";
  3. const agental = new Agental();
  4. const sandbox = await agental.sandboxes.get("sbx_2a9a47e50daec64a");
  5. await sandbox.desktop.off();
Answer200 OK · DesktopState
  1. {
  2. "enabled": boolean,
  3. "enabledAt": string | null,
  4. "running": boolean,
  5. "width": integer | null,
  6. "height": integer | null,
  7. "display": string | null,
  8. "url": string | null,
  9. }

The desktop is off.

Path

idrequired
string
 e.g. "sbx_0123456789abcdef"

Headers

Authorizationrequired
Bearer key
An API key that may make this call.

Returns

200 The desktop is off.

DesktopState7 fields
enabled
boolean
Whether a desktop is turned on for the sandbox.
More It stays so through a stop and a start, and a move to another server: the desktop is started again by itself, with nothing open on it.
enabledAt
stringnull
Since when it is on.
More Null when it is off.
running
boolean
Whether the desktop is running in the sandbox's machine now.
More False while it is off, while the sandbox is not running, and in the moments after a start before it is up again.
width
integernull
The width of its screen in pixels.
More Null while it is off.
height
integernull
The height of its screen in pixels.
More Null while it is off.
display
stringnull
What DISPLAY is to be for a command that opens a window on the desktop, or takes a picture of it.
More Null while it is off.
url
stringnull
Where the desktop is watched and used, in a browser.
More It needs no token and is hard to guess, and whoever has it sees the screen and can click and type on it, so it is to be kept as a password is. It is another each time the desktop is turned on. Null while the desktop is not running, and where GET /v1/policy says publicUrls is false.

Errors and other answers

404 Not found.

Every error answers { "error": { "code", "message" } }; a key without the action a call needs answers 403 key_action_forbidden, naming it.

← Enable desktopGet desktop screenshot →