API ReferenceDevice control
Read a device's telemetry history
Time-series readings this device has reported what an AI agent needs to learn patterns rather than only react to the latest value.
X-Api-Key<token>
A secret API key created on the dashboard (Settings → API Keys). 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
deviceId*string
Query Parameters
metric?string
limit?integer
Range
1 <= value <= 1000Default
100since?integer|null
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/devices/dev_a1b2c3/telemetry"[ { "metric": "string", "value": 0, "recordedAt": "2019-08-24T14:15:22Z" }]List supported hardware boards GET
Static reference data no authentication required. Used to populate the "board type" picker when registering a device.
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.