---
title: "Capture the screen"
method: GET
path: "/api/computers/{id}/screenshot"
tags: ["control"]
---

# Capture the screen

`GET /api/computers/{id}/screenshot`

## Request

- Base URL: `https://www.orgo.ai`
- URL: `https://www.orgo.ai/api/computers/{id}/screenshot`
- Auth: HTTP bearer

response_format url (default) stores the image and answers its path; base64 answers it inline with mime_type, width and height; binary answers the image bytes. format (png, jpeg, webp), quality (1 to 100, default 80) and scale (above 0, at most 1) shrink it. image_encoding=data_url (base64 only) prefixes the data URL header.

## Path parameters

- `id` string, required

## Query parameters

- `response_format` 'url' | 'base64' | 'binary'
- `format` 'png' | 'jpeg' | 'webp'
- `quality` integer
- `scale` number
- `image_encoding` 'data_url'
- `screen` string

## Response `200`

base64: { success, image, mime_type, width, height }. url: { success, image (the stored copy’s path, readable with the same key), metadata }. binary: the image.

- object
  - `success` boolean
  - `image` string
  - `mime_type` string
  - `width` integer
  - `height` integer
  - `metadata` object

## Other responses

- `400`: A query value out of range, or the computer has no VM.
- `429`: Over one of the account's rate limits (rate_limited): `limit` names it, `retry_after` and Retry-After say how many seconds to wait. Limits are per account (the workspace owner when the request acts on a computer or a workspace) and set by its plan (x-rate-limits).

## Changes

- **2026-11-01** `60e768a2bb9d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/orgo/apis/orgo-api/changes/api/computers/:id/screenshot/get.md)

---

[API](https://skmtc.dev/orgo/apis/orgo-api.md) - [All operations](https://skmtc.dev/orgo/apis/orgo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/orgo/apis/orgo-api/revisions/e4c1e7379fa5?raw)