Desktop ›
Type desktop text
POST
/v1/sandboxes/{id}/desktop/typeTypes text on the sandbox's desktop, a key at a time, where its keyboard's focus is: click the field first. A new line in the text is the Return key. Up to 4096 characters, which take about a second for each hundred.
RequestTypeScript
- import { Agental } from "agental-sdk";
- const agental = new Agental();
- const sandbox = await agental.sandboxes.get("sbx_2a9a47e50daec64a");
- await sandbox.desktop.type("hello");
Answer204 No Content
No body: the status says it was done.
Done.
Path
idrequiredstring | e.g. "sbx_0123456789abcdef" |
Headers
AuthorizationrequiredBearer key | An API key that may make this call. |
Body
textrequiredstring | e.g. "hello" |
Returns
204 Done. There is nothing to say back: GET /v1/sandboxes/{id}/desktop/screenshot shows what came of it.
Errors and other answers
| 400 | invalid_request a field is missing or is not what it has to be, or a point is not on the screen. The message says which. |
| 404 | Not found. |
| 409 | sandbox_not_running, or |
| 409 | desktop_not_running no desktop is turned on for the sandbox, or it is turned on and is not running yet, as in the moments after a start. PUT /v1/sandboxes/{id}/desktop turns it on, and starts one that ended. |
| 501 | desktop_not_configured sandboxes here have no desktop. GET /v1/policy says so as desktop. |
Every error answers { "error": { "code", "message" } }; a key without the action a call needs answers 403 key_action_forbidden, naming it.