---
title: "Scroll"
method: POST
path: "/v1/sessions/{sessionId}/scroll"
tags: ["OS Level Control"]
---

# Scroll

`POST /v1/sessions/{sessionId}/scroll`

Performs a scroll action at the specified coordinates

## Path parameters

- `sessionId` string, uuid, required

## Request body

- ScrollRequestSchema
  - `x` integer, required — X coordinate
  - `y` integer, required — Y coordinate
  - `deltaX` integer — Horizontal scroll amount (positive is right, negative is left)
  - `deltaY` integer, required — Vertical scroll amount (positive is down, negative is up)
  - `steps` integer — Number of steps to break the scroll into for smoother scrolling
  - `useOs` boolean — Whether to use the OS scroll or the Playwright scroll

## Response `200`

Scroll performed successfully

- object
  - `status` string

## Other responses

- `400` — Invalid coordinates or parameters
- `404` — Session not found
- `500` — Failed to perform scroll

## Changes

- **2025-10-16** `b7fe7610c0ce` — 3 info
  - the `deltaX` request property default value `0` was removed
  - the `steps` request property default value `1` was removed
  - the `useOs` request property default value `true` was removed

[Change history](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/changes/v1/sessions/:sessionId/scroll/post.md)

---

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