Set device settings

patch

https://{nurevaDeviceIP}/api/v1/settings

Allows clients to set device settings, such as the display theme (classic, dot) and time mode (12h, 24h, off) or power saving settings. See the Device settings Details for more information on the attributes and expected values.

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

Minimum role required: general

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
    }
}

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Headers

Nureva-Client-Id

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.

Nureva-Client-Version

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.

The request body for the device settings PATCH endpoint.

display

object

Object that groups all display settings

powerSaving

object

Object that groups all power-saving settings.

Responses

200Success

400Bad Request. Either one of the required headers are missing

401Unauthorized. Invalid or missing credentials

409Conflict error. Current device is not supported for this endpoint

429Too many requests. Rate limit is exceeded

500Internal Server Error. Unexpected error has occurred.