For every device the token and the device filters select, the number of
connect and disconnect device events in one window [start, end),
counted across every data partition the token can read. events is
connects + disconnects; latest_at is the time of the latest of those
events. Devices with no connect or disconnect in the window are not rows.
Use it to find devices that reconnect often: events_gt=100 keeps the
devices with more than 100 events in the window. Thresholds are ANDed.
total is the number of devices matching every filter, thresholds
included, across all pages.
Device filters are the ones GET /devices accepts, as
<field>_<operator>=<value> (for example company_id_in,
device_type_id_eq, tags_incany); the most used are listed below.
A count under an operator other than _gt (for example events_gte), or
start/end under any operator, is a 400, not an ignored filter.
page_meta is accepted and has no effect: the response always carries
the paging fields.
The token needs read access to devices and to device events.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Invalid window, threshold, order_by or paging value, a stats key under an unsupported operator, or unparseable device filters.
You are not authorized
The token may not read devices or device events, or names an ancestor_company_id it may not read.
The ancestor_company_id names no company.
An unexpected error was encountered.