---
title: "Mouse Click"
method: POST
path: "/v1/sessions/{sessionId}/mouse/click"
tags: ["OS Level Control"]
---

# Mouse Click

`POST /v1/sessions/{sessionId}/mouse/click`

Performs a mouse click at the specified coordinates

## Path parameters

- `sessionId` string, uuid, required

## Request body

- MouseSingleClickRequestSchema — Mouse click request. Must provide either (x, y) coordinates or a selector, but not both.
  - `x` number — X coordinate
  - `y` number — Y coordinate
  - `button` 'left' | 'middle' | 'right' — Mouse button to use
  - `selector` string — A valid CSS selector for the requested element
  - `timeout` number — If a selector was passed, timeout in ms for waiting for the DOM element to be selected. Defaults to 5000 (5 seconds).
  - `index` number — If a selector was passed and multiple elements match the selector, the index of the element in the list (0-based). Defaults to 0.

## Response `200`

Click performed successfully

- object
  - `status` string

## Other responses

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

## Changes

- **2025-12-14** `122673e8fdcf` — 1 breaking, 1 warning, 6 info
  - the request's body type/format changed from ``/`` to `object`/``
  - removed `#/components/schemas/CoordinatesRequestSchema, subschema #2` from the request body `allOf` list
  - added the new optional request property `button`
  - added the new optional request property `index`
  - …4 more
- **2025-10-16** `b7fe7610c0ce` — 1 info
  - the `button` request property default value `left` was removed

[Change history](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/changes/v1/sessions/:sessionId/mouse/click/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)