Actions
Take screenshot
Capture the display as a stored URL, inline base64, or image bytes.
GET
Take screenshot
Captures the computer’s display. By default it returns a stored image URL. Use
For a smaller response, request
Stored filenames and Content-Type match the encoded image:
response_format=binary for image bytes in the same response, or response_format=base64 for inline JSON. Inline responses skip storage and a second download.
Path parameters
Query parameters
Which screen to capture. Optional. Omit it to
capture the screen the computer booted with. An unknown id returns
404
rather than falling back to the default screen. A Windows computer ignores
this parameter.url, base64, or binary. Binary returns the image with its actual Content-Type.
Base64 returns {success, image, mime_type, width, height}, where image is raw base64.data_url makes a base64 response’s image a data URL (data:image/webp;base64,…)
instead of raw base64. Omit it for raw base64. Applies only with response_format=base64.An integer from 1 through 100. Applies when the image is re-encoded as JPEG
or WebP, which happens when you request a
format or a scale below 1.?response_format=binary&format=webp&quality=75&scale=0.5.
URL response
Path to the stored image, relative to
https://www.orgo.ai. For example:
/api/storage/4d96f9a0-1c2b-4f3e-9a7d-8b5c6e0f1a2d/2026-04-20T12-00-00-000Z_9f2b7c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d.png.
It is not an absolute URL, so join it to the origin before fetching. The path
does not expire, but it is not public: fetch it with the same
Authorization header, as an account that can view the computer’s
workspace. A request without credentials returns 401, and one without
access returns 404. A workspace-scoped key cannot fetch it at all (403),
so use response_format=base64 or binary with a scoped key..png, .jpg, or .webp. Inline responses use Cache-Control: private, no-store.
Example
Response
Errors
Every failure raised after the request leaves the API layer also carries a
request_id. Quote it in support requests. When the computer agent itself
answered non-2xx, the body additionally carries upstream_status.