Skip to main content
GET/api/public/v1/devices

devices.list

Paired machines with freshness, OS, health, session capacity and AdsPower-compatible API state.

Capability: device.readMCP tool: devices_list
View as Markdown

Parameters

This operation takes no input.

Examples

curl "https://browlix.com/api/public/v1/devices" \
  -H "Authorization: Bearer $BROWLIX_API_KEY"

Response

200 with { data, correlation_id }.

FieldTypeAlways presentDescription
dataarray<object>Yes
data[].idstring (uuid)Yes
data[].namestringYes
data[].os"windows" | "linux"Yes
data[].statestringYesactive, revoked, …
data[].freshnessstringYescurrent when the machine reported recently
data[].agent_versionstring | nullYes
data[].last_seen_atstring (date-time) | nullYes
data[].revisionintegerYes(min -9007199254740991, max 9007199254740991)
data[].healthobject | nullYes
data[].sessionsobjectYes
data[].sessions.runningintegerYes(min -9007199254740991, max 9007199254740991)
data[].sessions.capacityintegerYes(min -9007199254740991, max 9007199254740991)
data[].adspower_apiobjectYes
data[].adspower_api.enabledbooleanYes
data[].adspower_api.supportedbooleanYes
data[].adspower_api.portinteger | nullNo
data[].storageobject | nullYes
correlation_idstring (uuid)Yes

New fields can appear at any time; ignore the ones you do not know.

Errors

CodeHTTPRetryable
UNAUTHENTICATED401No
FORBIDDEN403No
RATE_LIMITED429Yes
DEPENDENCY_UNAVAILABLE503Yes
UNKNOWN500No

Every error code and when to retry

All operations