---
title: "Scroll mouse wheel"
method: POST
path: "/v1/computer/{machine_id}/input/mouse/scroll"
tags: ["computer"]
---

# Scroll mouse wheel

`POST /v1/computer/{machine_id}/input/mouse/scroll`

## Request

- Base URL: `https://api.cyberdesk.io`
- URL: `https://api.cyberdesk.io/v1/computer/{machine_id}/input/mouse/scroll`
- Auth: HTTP bearer

Scroll the mouse wheel in the specified direction by a number of steps.
Optionally moves to (x, y) before scrolling.

## Path parameters

- `machine_id` string, required

## Headers

- `Idempotency-Key` string

## Request body

- MouseScrollRequest
  - `direction` string, required: Scroll direction: 'up', 'down', 'left', or 'right'
  - `amount` integer, required: Number of scroll steps (clicks); non-negative integer
  - `x` integer, nullable
  - `y` integer, nullable

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud.md) - [All operations](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud/revisions/5579352ae05e?raw)