Skip to content
Sandbox Agent
GitHub Get Started
HTTP API

Drag the desktop mouse.

POST
/v1/desktop/mouse/drag

Performs a health-gated drag gesture against the managed desktop and returns the resulting mouse position.

Request Body required

Section titled “Request Body required ”
object
button
string
Allowed values: left middle right
endX
required
integer format: int32
endY
required
integer format: int32
startX
required
integer format: int32
startY
required
integer format: int32

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Desktop mouse position after drag

object
screen
integer format: int32
nullable
window
string
nullable
x
required
integer format: int32
y
required
integer format: int32

400

Section titled “400 ”

Invalid mouse drag request

object
detail
string
nullable
instance
string
nullable
status
required
integer format: int32
title
required
string
type
required
string
key
additional properties

409

Section titled “409 ”

Desktop runtime is not ready

object
detail
string
nullable
instance
string
nullable
status
required
integer format: int32
title
required
string
type
required
string
key
additional properties

502

Section titled “502 ”

Desktop runtime health or input failed

object
detail
string
nullable
instance
string
nullable
status
required
integer format: int32
title
required
string
type
required
string
key
additional properties