Read the most recent value per telemetry metric
The quickest "current state" snapshot - one row per metric this device has ever reported, plus its relay state.
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
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/devices/dev_a1b2c3/telemetry/latest"{ "state": null, "relayState": true, "telemetry": [ { "metric": "string", "value": 0, "recordedAt": "2019-08-24T14:15:22Z" } ]}Read a device's telemetry history GET
Time-series readings this device has reported what an AI agent needs to learn patterns rather than only react to the latest value.
Send a command to a device POST
The general-purpose command endpoint - validates the command and its params against the device's catalog, checks the caller's DeviceGrant, then either publishes it over MQTT immediately or (for a command marked `requiresApproval`) creates a pending approval instead of executing it. An API key needs a DeviceGrant covering this device and this command name - see the Authentication & Access guide.