Return the deCONZ gateway configuration (firmware, network, Zigbee channel, etc.).

Open the Zigbee network so new devices can join.

Args: duration: Seconds to allow joining (0–255). Use 0 to close immediately. Default is 60 seconds.

List all lights known to the deCONZ gateway with their current state.

Get full details of a specific light including state, attributes, and capabilities.

Args: light_id: Numeric light ID (use list_lights to discover IDs).

Control a light's power, brightness, colour, or effect.

Args: light_id: Numeric light ID. on: True to turn on, False to turn off. brightness: Brightness 1–254 (only when on=true). hue: Hue 0–65535. saturation: Saturation 0–254. color_temp: Colour temperature in mireds (153–500; lower=cooler). xy: CIE xy colour as [x, y] (each 0.0–1.0). transition_time: Transition duration in 1/10ths of a second (default 4 = 0.4 s). alert: "none", "select" (single blink), or "lselect" (15-second blink cycle). effect: "none" or "colorloop".

Rename a light.

Args: light_id: Numeric light ID. name: New display name (max 32 characters).

Remove a light from the gateway.

Args: light_id: Numeric light ID to remove.

List all light groups with their current action state.

Get full details of a light group including member lights and scenes.

Args: group_id: Numeric group ID (use list_groups to discover IDs).

Create a new light group.

Args: name: Display name for the group. light_ids: Optional list of light IDs to add initially (e.g. ["1", "3", "5"]).

Control all lights in a group simultaneously.

Args: group_id: Numeric group ID. on: True to turn on, False to turn off. brightness: Brightness 1–254. hue: Hue 0–65535. saturation: Saturation 0–254. color_temp: Colour temperature in mireds (153–500). xy: CIE xy colour as [x, y]. transition_time: Transition duration in 1/10ths of a second. alert: "none", "select", or "lselect". effect: "none" or "colorloop". scene: Scene ID to recall (within this group).

Rename a group or change its member lights.

Args: group_id: Numeric group ID. name: New display name. light_ids: Complete new list of light IDs for this group.

Delete a light group (lights remain, only the group is removed).

Args: group_id: Numeric group ID to delete.

List all scenes defined for a group.

Args: group_id: Numeric group ID (use list_groups to discover IDs).

Get details of a specific scene.

Args: group_id: Numeric group ID. scene_id: Scene ID (use list_scenes to discover IDs).

Create a new scene that captures the current state of all lights in the group.

Args: group_id: Numeric group ID. name: Display name for the scene.

Activate (recall) a scene — all lights in the group transition to the saved state.

Args: group_id: Numeric group ID. scene_id: Scene ID to activate.

Overwrite a scene with the current state of all lights in the group.

Args: group_id: Numeric group ID. scene_id: Scene ID to overwrite.

Rename a scene.

Args: group_id: Numeric group ID. scene_id: Scene ID to rename. name: New display name.

Delete a scene.

Args: group_id: Numeric group ID. scene_id: Scene ID to delete.

List all sensors (temperature, humidity, presence, switches, etc.) with current state.

Get full details of a specific sensor including state, config, and capabilities.

Args: sensor_id: Numeric sensor ID (use list_sensors to discover IDs).

Rename a sensor.

Args: sensor_id: Numeric sensor ID. name: New display name.

Update a sensor's configuration.

Args: sensor_id: Numeric sensor ID. on: Enable or disable the sensor. reachable: Mark the sensor as reachable (admin override). battery: Battery level 0–100 (admin override for CLIP sensors). sensitivity: Motion sensitivity level (where supported).

Remove a sensor from the gateway.

Args: sensor_id: Numeric sensor ID to remove.

List all automation rules with their status and trigger conditions.

Get full details of an automation rule including conditions and actions.

Args: rule_id: Numeric rule ID (use list_rules to discover IDs).

Create an automation rule triggered by sensor conditions.

Args: name: Rule display name. conditions: List of condition objects, e.g.: [{"address": "/sensors/1/state/buttonevent", "operator": "eq", "value": "1002"}] actions: List of action objects, e.g.: [{"address": "/groups/1/action", "method": "PUT", "body": {"on": true}}] status: "enabled" or "disabled".

Condition operators: eq, gt, lt, dx (changed), ddx (stable for duration), stable, not stable.

Enable or disable an automation rule.

Args: rule_id: Numeric rule ID. status: "enabled" or "disabled".

Delete an automation rule.

Args: rule_id: Numeric rule ID to delete.

List all timed schedules with their next trigger time and status.

Get full details of a schedule including its command and timing.

Args: schedule_id: Numeric schedule ID (use list_schedules to discover IDs).

Create a timed schedule that sends a command to the gateway.

Args: name: Schedule display name. time: ISO 8601 time expression. Examples: "2025-12-31T23:00:00" — absolute UTC datetime "W127/T08:00:00" — weekly (Mon+Tue+Wed, 08:00) "PT01:00:00" — timer (1 hour from now) "R/PT01:00:00" — recurring timer every hour command_address: API path the schedule calls, e.g. "/api//groups/1/action". command_method: HTTP method: "PUT", "POST", or "DELETE". command_body: JSON body for the command, e.g. {"on": true}. description: Optional human-readable description. status: "enabled" or "disabled". autodelete: If true, the schedule is deleted after it fires once.

Enable or disable a schedule.

Args: schedule_id: Numeric schedule ID. status: "enabled" or "disabled".

Delete a schedule.

Args: schedule_id: Numeric schedule ID to delete.

Start a Touchlink scan to discover nearby Zigbee devices (takes ~10 seconds).

After scanning, call get_touchlink_results to see discovered devices.

Return results from the last Touchlink scan.

Make a Touchlink device blink to identify itself.

Args: touchlink_id: Device ID from get_touchlink_results.

Factory-reset a Touchlink device (removes it from its current network).

Args: touchlink_id: Device ID from get_touchlink_results.

Warning: This resets the device to factory defaults and removes it from the gateway.