Skip to main content
POST
Report device health status including battery level, storage usage, and signal strength. Health data is stored on the device record and returned in Get Device and List Devices responses.

Authentication

This endpoint accepts two authentication methods depending on the device connectivity:

Path Parameters

id
string
required
The device’s unique identifier (e.g., dev_abc123), or me when using a device token. The me alias resolves to the device ID associated with the token, so the device doesn’t need to know its own Bota ID. When using an explicit device ID with a device token, it must match the token’s device.

Request Body

All fields are optional — send only the metrics your device can report.
battery_percent
integer
Current battery level (0-100).
battery_mv
integer
Battery voltage in millivolts (e.g., 3700 = 3.7V). Useful for diagnosing power issues.
is_charging
boolean
Whether the device is currently charging.
storage_used_mb
integer
Storage used in megabytes.
storage_total_mb
integer
Total storage capacity in megabytes.
signal_strength_dbm
integer
Cellular signal strength in dBm (typically -50 to -120, where higher/less negative is better).
firmware_version
string
Current firmware version string (max 32 characters).
device_name
string
Device name (max 64 characters). Updated in the device record when provided.
device_state
string
Current device operational state (max 32 characters). One of: idle, recording, syncing, uploading, charging, lowBattery, storageFull, error.
pending_recordings
integer
Number of recordings on the device pending sync/upload.
flags
integer
Device status flags as a 1-byte bitmask (0-255). Bit 0: charging, Bit 1: low battery, Bit 2: storage full, Bit 3: WiFi connected, Bit 4: LTE connected, Bit 5: sync active.
lte_status
string
LTE/4G modem status. One of: off, searching, registered, connected, denied, no_sim, error, low_voltage, disabled.
wifi_status
string
WiFi radio status. One of: off, scanning, connecting, connected, connect_failed, no_credentials, disabled, error.
connection_type
string[]
Active device connections. Array of: wifi, 4g, ble.
upload_channel
string
The channel currently being used to upload recordings. One of: wifi, 4g, ble. Set to null to clear. Omit if no upload is in progress.

Response

Returns { "status": "ok" } on success.

Response Fields

Field Constraints