Set device settings

Allows clients to set device settings, such as the display theme (classic, dot) and time mode (12h, 24h, off) or power saving, HDX lights style (Dot, Eclipse), lights inCallColour (Blue, Green), light brightness (Off, Low, Medium, High) and device sounds (Essential, All) settings.

NOTE: Only supported for HDL200, HDL300, Dual HDL300 and HDX devices.

admin role required

Example Request Body for HDL200 (only supports display settings)

{
    "display": {
      "theme": "classic",
      "timeMode": "12h",
    }
}

Example Request Body for HDL300 and Dual HDL300 (only supports power saving settings)

{
    "powerSaving": {
      "sleepModeEnabled": true
    }
}

Example Request Body for HDX (only supports light modes and device sounds settings)

{
  "lights": {
    "style": "Dot",
    "inCallColour": "Blue",
    "brightness": "Medium"
  },
  "deviceSounds": "Essential"
}
Headers
string
required

Identifier for the integration application or service. This is intended for you to specify the name of your integration. Use this same value every time your integration calls into the Nureva device. There is no strict format as long as the value is limited to 500 characters. For example, "MyCompany Integration", "Power API", "SyncMaster", "Cloud Orchestrator", "Ultimate Audio Overlord" are all acceptable values.

string
required

Identifier for the integration version. This is intended for you to specify the version of your integration application or service. There is no strict format as long as the value is limited to 500 characters. For example, "1", "2.0", "1.5.2", "beta", "1.0.0-alpha", "1.0.0+20250102" are all acceptable values.

Body Params

The request body to configure the device settings.

display
object

Object that groups all display settings

powerSaving
object

Object that groups all power-saving settings.

lights
object

Object that groups all light settings

string
enum

The preference for playing device sounds.

Allowed:
Responses

Language
Credentials
Header
URL
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json