Get a room

GET /clip/v2/resource/room/room_uuid

Get a room by UUID, including its properties and resource references.

Example response

{
  "code": 0,
  "msg": "string",
  "data": {
    "obj": {
      "id": "string",
      "type": "string",
      "name": "string",
      "room_kind": 0,
      "room_type": "string",
      "icon": "string",
      "background": 0,
      "sequence": 0,
      "children": [
        {
          "rid": "string",
          "rtype": "string"
        }
      ],
      "services": [
        {
          "rid": "string",
          "rtype": "string"
        }
      ]
    }
  }
}

Responses

Status code	Meaning
200	OK

Response fields

HTTP 200 OK

Field	Type	Required	Description
code	integer	Yes	Status code
msg	string	Yes	Message
data	object	Yes	Response payload.
data.obj	object	Yes	Returned resource.
data.obj.id	string	Yes	Room UUID
data.obj.type	string	Yes	Always room.
data.obj.name	string	Yes	Room name.
data.obj.room_kind	integer	Yes	0 for a standard room; 1 for Whole Home; 2 for Unassigned.
data.obj.room_type	string	Yes	A free-form room category, such as "Bedroom" or "Kitchen".
data.obj.icon	string	Yes	For BweeApp use only.
data.obj.background	integer	Yes	For BweeApp use only.
data.obj.sequence	integer	Yes	For BweeApp use only.
data.obj.children	ResInfo[]	Yes	Devices in the room. Each entry currently refers to a device resource.
data.obj.children[].rid	string	Yes	Resource UUID
data.obj.children[].rtype	string	Yes	Resource type
data.obj.services	ResInfo[]	Yes	Typically includes a group_light service for controlling the room's lights.
data.obj.services[].rid	string	Yes	Resource UUID
data.obj.services[].rtype	string	Yes	Resource type