Status report (only when Wi-Fi is already on)

POST

/device/heartbeat

Sent at most once per heartbeat_interval_s (from the last reply), only when Wi-Fi is on for
another reason. Failures are ignored by the device. Does not return commands.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404UnknownDevice

🟠429RateLimited

Request Example

Shell

JavaScript

Java

Swift

curl --location '/device/heartbeat' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "device_id": "MyDevice-A0CDCB",
    "firmware_version": "0.1.0",
    "timestamp": "2026-10-06T13:07:32Z",
    "time_trusted": true,
    "pending_events": 0,
    "wifi_rssi": -61
}'

Response Example

200 - Success

{
    "status": "ok",
    "server_time": "2026-10-06T13:07:33Z",
    "heartbeat_interval_s": 1800
}

Modified at 2026-10-07 14:49:40

Report the outcome of each command

Server time (fallback when NTP is blocked)