List every light on the bridge with on/off state, brightness, colour, and owner.

owner.rid points to the parent device — useful when one device exposes multiple light services. To find which room a light belongs to, cross-reference the device id against list_rooms() children.

List rooms with their grouped_light_id (use with set_group) and member devices.

List zones with their grouped_light_id (use with set_group) and member lights.

Zones differ from rooms: a light belongs to exactly one room but can be in many zones (e.g. a "Downstairs" zone spanning Kitchen + Living room).

List scenes. If group_id is given (a room or zone id), only scenes targeting that group are returned. Use the returned id with activate_scene.

Generic escape hatch — fetch a Hue resource by type, optionally by id.

rtype is a CLIP v2 resource type, e.g. light, room, zone, scene, grouped_light, device, bridge, motion, temperature, button, behavior_instance, smart_scene. Returns the raw bridge payload — useful when you need fields the higher-level tools don't expose.

Update one light. Pass only the attributes you want to change.

Use list_lights() to discover what each light supports — it returns effects.available, timed_effects.available, and (for gradient strips) a gradient block with points_capable and mode_values.

• brightness is 0–100 (percent). Setting brightness on an off light does NOT turn it on; pass on=True as well.

• color_temp_mirek is the CIE mired value; the per-light valid range is reported by list_lights() as color_temp_range_mirek (commonly 153–500, i.e. ~6500K–2000K). Setting this clears any active colour.

• color_xy is a 2-element list [x, y] in CIE 1931 colour space, clamped to the light's gamut. Setting this clears any active colour temperature.

• effect is one of the values from effects.available (e.g. no_effect, candle, fire, prism, sparkle, opal, glisten). Pass no_effect to stop a running effect.

• gradient_points is a list of [x, y] CIE 1931 points (typically 2–5, capped by the light's gradient.points_capable). Only meaningful for gradient-capable strips like the Hue Play Gradient lightstrip.

• gradient_mode is one of the light's gradient.mode_values — interpolated_palette (default smooth blend), interpolated_palette_mirrored, random_pixelated, or segmented_palette.

• timed_effect is sunrise, sunset, or no_effect. Use timed_effect_duration_ms to set how long the effect runs.

• transition_ms is the fade duration in milliseconds for on/off, dimming, and colour changes.

Control all lights in a room or zone at once via its grouped_light_id.

Get this id from list_rooms() or list_zones() (grouped_light_id field). Same parameters as set_light, minus per-light effects.

Recall a scene — applies its stored light states to its target group.

• action is active (default), dynamic_palette (cycles through the scene's palette), or static (one-shot apply with no dynamics).

• brightness (0–100) overrides the scene's stored brightness.

• transition_ms overrides the scene's default fade duration.

Make a light breathe (briefly pulse) so you can physically locate it.

Return basic bridge identity (name, id, software version, time-zone).