Groups
27 | 28 |Groups allow you to group your lights, useful to control them all at the 29 | same time with just one API call.
30 | 31 |Note: There exists a special group with a number of 0, which contains all 32 | lights known to the bridge. Issuing operations on group #0 will change all 33 | lights simultaneously.
34 | 35 |-
36 |
- List all groups 37 |
- Show group information 38 |
- Controlling all lights in a group 39 |
List all groups
40 | 41 |GET /api/username/groupsResponse
44 | 45 |No meaningful response known yet.
46 | 47 |Show group information
48 | 49 |Information retrieved is not live-updated from all lights. Values returned are simply 50 | the values that were last assigned.
51 | 52 |GET /api/username/groups/numberParameters
55 | 56 |-
57 |
- number 58 |
- group number of the group you wish to control, 0 for a group which contains all lights. 59 |
Response
60 | 61 |GET /api/username/groups/0{
64 | "action": {
65 | "on": true,
66 | "bri": 254,
67 | "hue": 13122,
68 | "sat": 211,
69 | "xy": [
70 | 0.5119,
71 | 0.4147
72 | ],
73 | "ct": 467,
74 | "effect": "none",
75 | "colormode": "ct"
76 | },
77 | "lights": [
78 | "1",
79 | "2",
80 | "3"
81 | ],
82 | "name": "Lightset 0"
83 | }Controlling all lights in a group
86 | 87 |PUT /api/username/groups/number/actionParameters
90 | 91 |See the API for “Changing light color and turning them on/off”.
92 | 93 |Input
94 | 95 |{
96 | "on": true,
97 | "hue": 25000
98 | }Response
101 | 102 |[
103 | {
104 | "success": {
105 | "/groups/0/action/on": true
106 | }
107 | },
108 | {
109 | "success": {
110 | "/groups/0/action/hue": 13000
111 | }
112 | }
113 | ]