Read a device's telemetry history
Time-series readings this device has reported, newest first, what an AI agent needs to learn patterns rather than only react to the latest value.
Example: GET /devices/dev_a1b2c3/telemetry?metric=temperature&limit=50 returns the last 50 temperature readings. Omit metric to get every metric this device reports, mixed together in one list.
A secret API key created on the dashboard (API Keys page). By itself it grants nothing - it must also have a DeviceGrant scoping it to the specific device(s) and command(s) it may call.
In: header
Path Parameters
Query Parameters
Only return readings for this metric name, omit to get every metric this device reports.
Max rows to return, 1-1000. Defaults to 100.
1 <= value <= 1000100Unix milliseconds - only return readings recorded at or after this time. Omit for no lower bound.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/devices/dev_a1b2c3/telemetry?metric=temperature&limit=50&since=1732000000000"[ { "metric": "temperature", "value": 21.4, "valueText": null, "unit": "celsius", "recordedAt": "2024-11-19T10:00:00.000Z" }, { "metric": "temperature", "value": 21.6, "valueText": null, "unit": "celsius", "recordedAt": "2024-11-19T10:05:00.000Z" }]List supported hardware boards GET
Static reference data no authentication required. Used to populate the "board type" picker when registering a device - `boardType` in POST /devices/register is free text, this is just suggestions, not an enforced list.
Read the most recent value per telemetry metric GET
The quickest "current state" snapshot - one row per metric this device has ever reported, plus its relay state. Use this instead of `/telemetry` when you just need "what is this device's situation right now", not history.