---
title: "Run computer actions"
method: POST
path: "/v1/instance/{instance_id}/computer"
tags: ["instance"]
---

# Run computer actions

`POST /v1/instance/{instance_id}/computer`

## Path parameters

- `instance_id` string, required

## Headers

- `x-api-key` string, required

## Request body

- union
  - object
    - `action` 'move_mouse', required — Discriminator value: move_mouse
    - `coordinates` integer[], required
    - `hold_keys` string[]
    - `screenshot` boolean
  - object
    - `action` 'click_mouse', required — Discriminator value: click_mouse
    - `button` 'left' | 'right' | 'middle' | 'back' | 'forward', required
    - `click_type` 'down' | 'up' | 'click'
    - `coordinates` integer[]
    - `num_clicks` integer
    - `hold_keys` string[]
    - `screenshot` boolean
  - object
    - `action` 'drag_mouse', required — Discriminator value: drag_mouse
    - `path` array[], required
      - integer[]
    - `hold_keys` string[]
    - `screenshot` boolean
  - object
    - `action` 'scroll', required — Discriminator value: scroll
    - `coordinates` integer[]
    - `delta_x` number, double
    - `delta_y` number, double
    - `hold_keys` string[]
    - `screenshot` boolean
  - object
    - `action` 'press_key', required — Discriminator value: press_key
    - `keys` string[], required
    - `duration` number, double
    - `screenshot` boolean
  - object
    - `action` 'type_text', required — Discriminator value: type_text
    - `text` string, required
    - `hold_keys` string[]
    - `screenshot` boolean
  - object
    - `action` 'wait', required — Discriminator value: wait
    - `duration` number, double, required
    - `screenshot` boolean
  - object
    - `action` 'take_screenshot', required — Discriminator value: take_screenshot
  - object
    - `action` 'get_cursor_position', required — Discriminator value: get_cursor_position

## Response `200`

Successful Response

- TypeComputerResponse — Response model for computer actions.
  - `output` string
  - `error` string
  - `base64_image` string
  - `system` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/scrapybara/apis/api-reference.md) · [All operations](https://skmtc.dev/scrapybara/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scrapybara/api-reference/revisions/3d9197361372/schema)