List the Deco units that form the mesh: the gateway and every satellite.

Returns each unit's MAC, name, model, role (master is the gateway), LAN IP, hardware and firmware versions, internet status as the unit sees it, and the backhaul signal level per band.

Report how busy the gateway is and how much traffic flows through the mesh right now.

Returns CPU and memory usage of the gateway in percent, the number of online clients and the summed instantaneous download and upload rates of every client, in kilobytes per second.

Report whether the mesh is online and how the gateway reaches the provider.

Returns the WAN cable state, the IPv4 and IPv6 connection state (online/offline, protocol such as pppoe, router error code), the public WAN address with its gateway and DNS servers, and the gateway's LAN address. Use it to diagnose an internet outage.

Describe the Wi-Fi networks the mesh broadcasts and how each radio is tuned.

Returns every network (main, guest, iot, mlo) with its SSID, whether it is enabled, the bands it is broadcast on and whether it is hidden, plus each radio band's channel, channel width, 802.11 mode and backhaul channel. Passwords are left out unless include_passwords is set.

List the devices (phones, computers, TVs, IoT gadgets) the mesh knows about.

Returns each device's MAC, name, IP, whether it is online, the network it joined (main, guest, iot, mlo), how it connects (wired or the radio band), its category, the Deco unit it is attached to, its instantaneous download/upload rate and whether QoS prioritizes it. The MAC is the key every other client tool takes; find it here first when the user names a device.

Rename a device and optionally change its category in the Deco app.

The router only applies an edit that carries a name, so name is always required.

Forget a device that is no longer used, removing it from the client list.

Meant for offline devices: the router lists the device again as soon as it reconnects. This does not block it — use block_client for that.

List the devices that are blocked from the internet across the whole mesh.

Returns each blocked device's MAC, the name and the category stored with the block.

Block a device from the internet on every Deco unit; it stays on the local network.

name and client_type default to what list_clients shows for the device, so they are only needed for a device the mesh does not list.

Restore internet access for a device on the blocklist.

List the fixed IPs the DHCP server always hands to the same device.

Returns each reservation's MAC and IP with the device name the mesh shows for that MAC (null when the device is not on the client list), and the most reservations the router accepts.

Reserve a fixed IP for a device that has none yet.

The device picks the address up on its next DHCP renewal or reconnect. Use update_address_reservation when the device already has one.

Move a device's existing fixed IP reservation to another address.

Drop a device's fixed IP reservation; it gets a dynamic address on its next renewal.

Read one page of the router's system log, newest page by default.

Returns up to 100 lines from oldest to newest (time, syslog facility and level, the process that wrote it, message), the page count, and the severities that can be passed as severity. Use it to explain outages, PPPoE reconnects, reboots, DHCP or Wi-Fi events. The newest page can hold only a few lines, so read the page before it when more context is needed. The router keeps a limited buffer, so older history may already be gone.