Skip to content
GitHub Get Started
HTTP API

Capture a desktop screenshot region.

GET
/v1/desktop/screenshot/region

Performs a health-gated screenshot crop against the managed desktop and returns the requested region image bytes.

x
required
integer format: int32
y
required
integer format: int32
width
required
integer format: int32
height
required
integer format: int32
format
string
Allowed values: png jpeg webp
quality
integer format: int32
nullable
scale
number format: float
nullable
showCursor
boolean
nullable

Desktop screenshot region as image bytes

Invalid screenshot region

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

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

Desktop runtime health or screenshot capture failed

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