API Reference

Computers

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Click and drag

client.computers.drag(stringid, ComputerDragParams { tab_id, x1, x2, 2 more } body, RequestOptionsoptions?): ActionResult { error_message, executed_tab_id, page_context, 4 more }

POST/computers/{id}/drag

Perform a click-and-drag action from (x1,y1) to (x2,y2). Coordinates are screenshot pixel positions. Optionally specify tab_id (browser sessions only)

ParametersExpand Collapse

id: string

body: ComputerDragParams { tab_id, x1, x2, 2 more }

tab_id?: string

x1?: number

x2?: number

y1?: number

y2?: number

ReturnsExpand Collapse

ActionResult { error_message, executed_tab_id, page_context, 4 more }

error_message?: string

executed_tab_id?: string

page_context?: V2GoBackendInternalTypesPageContext { device_scale_factor, is_main_tab, page_height, 8 more }

device_scale_factor?: number

is_main_tab?: boolean

page_height?: number

page_width?: number

scroll_x?: number

scroll_y?: number

tab_id?: string

title?: string

url?: string

viewport_height?: number

viewport_width?: number

request_id?: string

result?: Record<string, unknown>

status?: string

timestamp?: string

Click and drag

TypeScript

HTTP

TypeScript

Python

import Lightcone from '@tzafon/lightcone';

const client = new Lightcone({
  apiKey: process.env['TZAFON_API_KEY'], // This is the default and can be omitted
});

const actionResult = await client.computers.drag('id');

console.log(actionResult.executed_tab_id);

200 example

{
  "error_message": "error_message",
  "executed_tab_id": "executed_tab_id",
  "page_context": {
    "device_scale_factor": 0,
    "is_main_tab": true,
    "page_height": 0,
    "page_width": 0,
    "scroll_x": 0,
    "scroll_y": 0,
    "tab_id": "tab_id",
    "title": "title",
    "url": "url",
    "viewport_height": 0,
    "viewport_width": 0
  },
  "request_id": "request_id",
  "result": {
    "foo": "bar"
  },
  "status": "status",
  "timestamp": "timestamp"
}

Returns Examples

200 example

{
  "error_message": "error_message",
  "executed_tab_id": "executed_tab_id",
  "page_context": {
    "device_scale_factor": 0,
    "is_main_tab": true,
    "page_height": 0,
    "page_width": 0,
    "scroll_x": 0,
    "scroll_y": 0,
    "tab_id": "tab_id",
    "title": "title",
    "url": "url",
    "viewport_height": 0,
    "viewport_width": 0
  },
  "request_id": "request_id",
  "result": {
    "foo": "bar"
  },
  "status": "status",
  "timestamp": "timestamp"
}