Update Device Settings
Update the settings of the device.
The body is a partial update: only the fields it names are changed, the
rest keep their current value. false and "" are values like any
other, so {"wifi_enabled": false} turns WiFi off, while a body that
omits wifi_enabled leaves it as it is. An unrecognised field is
rejected with 400 rather than ignored, so a typo cannot silently read
as “leave this one alone”. null means the same as omitting the field —
to clear a string, send "". An inactivity_timeout other than 0 or
60–86400 is rejected with 400, and so is a playback label longer
than 20 characters or with a character outside printable ASCII.
Authorizations
Headers
Body
Device settings. Every field is optional in both directions: a request carries only the
fields it wants to change, and a response omits a field the device does not report. An
explicit false is a value, not an omission, so sending wifi_enabled: false or
ble_enabled: false can drop the connection you are using. An unknown field name is
rejected with 400.
Seconds without activity before the device powers off. 0 means never; any other value
must be within 60–86400, otherwise the request is rejected with 400. Firmware uses
900 (15 minutes) until a value is set. Supported from firmware v0.6.9; older firmware
ignores it. Missing from a response when the device has it set to 0 or runs older
firmware.
0 900
Title of the Script Playback screen. Empty shows the default "Script Playback". A request
takes up to 20 characters of printable ASCII (codes 32–126); anything else is rejected
with 400. A label written over BLE may hold other characters and is returned as is.
The device loses it on restart. Missing from a response when empty or when the firmware
does not support it.
20"Now playing"
Line under the Script Playback title, e.g. the video name. Empty shows nothing. A request
takes up to 20 characters of printable ASCII (codes 32–126); anything else is rejected
with 400. A label written over BLE may hold other characters and is returned as is.
The device loses it on restart. Missing from a response when empty or when the firmware
does not support it.
20"Beach sunset"
Response
Updated Device Settings
Device settings. Every field is optional in both directions: a request carries only the
fields it wants to change, and a response omits a field the device does not report. An
explicit false is a value, not an omission, so sending wifi_enabled: false or
ble_enabled: false can drop the connection you are using. An unknown field name is
rejected with 400.
Seconds without activity before the device powers off. 0 means never; any other value
must be within 60–86400, otherwise the request is rejected with 400. Firmware uses
900 (15 minutes) until a value is set. Supported from firmware v0.6.9; older firmware
ignores it. Missing from a response when the device has it set to 0 or runs older
firmware.
0 900
Title of the Script Playback screen. Empty shows the default "Script Playback". A request
takes up to 20 characters of printable ASCII (codes 32–126); anything else is rejected
with 400. A label written over BLE may hold other characters and is returned as is.
The device loses it on restart. Missing from a response when empty or when the firmware
does not support it.
20"Now playing"
Line under the Script Playback title, e.g. the video name. Empty shows nothing. A request
takes up to 20 characters of printable ASCII (codes 32–126); anything else is rejected
with 400. A label written over BLE may hold other characters and is returned as is.
The device loses it on restart. Missing from a response when empty or when the firmware
does not support it.
20"Beach sunset"