Get room device configuration

get

https://{nurevaDeviceIP}/api/v1/room/devices/{deviceId}

Allows clients to retrieve the current configuration for a specific room device identified by deviceId. The response varies based on the configured device type and can include details such as device metadata.

Minimum role required: general

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

deviceId

string

required

Unique identifier for the configured room device.

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.

Responses

200Success

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

401Unauthorized. Invalid or missing credentials

403Forbidden. The authenticated user does not have sufficient permissions for this endpoint

404Device not found. Invalid or missing deviceId

429Too many requests. Rate limit is exceeded

500Internal Server Error. Unexpected error has occurred.