List all devices (physical and logical) with their current states and aliases.

Hardware identity for every device: vendor, product/model name, node label, hardware/software versions, serial number, unique id, and Matter device-type ids. Physical Matter devices carry the full set (from Basic / Bridged Device Basic Information); logical devices report id + names only. Use to tell apart bridged children of one hub (e.g. Aqara sensors) that changed IDs after a re-pairing. If id is given, return just that one device — i.e. decode a dev_ id back to its node_id/endpoint_id + identity (the id is a one-way hash, so this is the way back).

List lighting devices with normalized brightness (0.0-1.0) and color temperature (Kelvin).

List sensor devices with their metrics (illuminance, temperature, humidity, occupancy, etc.).

Get a single sensor's data by device ID.

Read temperature (°C) and/or humidity (%) for every device that reports them (Thermostat local_temperature + standalone temp/humidity sensors). If id is given, return one device only. Each entry has kind = "thermostat" or "sensor".

Quick summary: how many lights on/off, active sensors, connected bridges, total devices.

Control a device. Brightness: 0.0 (off) to 1.0 (full). Temperature: Kelvin (e.g. 4000).

Toggle a device on or off. If on, turns off. If off, turns on at full brightness.

Set raw brightness level (0-254) for a device.

Set color temperature in mireds for a device.

Control multiple devices at once. Each action: {"id": "...", "brightness": 0.5, "temperature": 4000}.

Assign a display alias to a device. Aliases are for display only, not for ID resolution.

Remove an alias from a device.

Register a remote logical bridge by IP and port. Optional api_key for authenticated peers (sent in the request body, never the URL).

Remove a registered logical bridge.

Commission a new Matter device using its pairing code (sent in the body, never the URL). Optionally specify IP and a name.

Unpair a fabric node by node_id (clean up phantom/duplicate entries).

Declarative bridge metadata (capabilities + states per device), as consumed by federation peers. HTTP-only on the REST side (/api/metadata).

List all ACs (Matter Thermostat endpoints) with on/off, system_mode, local temp, and setpoints in °C.

Get a single AC's state by device ID.

Control an AC.

• on=True turns on (resumes last non-zero SystemMode, defaulting to Cool=3); on=False turns off.

• mode (overrides on): 0=Off, 1=Auto, 3=Cool, 4=Heat, 5=EmergencyHeat, 6=Precooling, 7=FanOnly, 8=Dry, 9=Sleep.

• setpoint: in °C (e.g. 26.0); routed to the heating or cooling setpoint by mode.

• fan_speed (0-100): forwarded to logical-bridge ACs that support it; rejected on physical Matter ACs.

Force refresh all device states from Matter bridge and logical bridges.