manage_device
Update a UniFi device's name and properties using a role-location naming convention for clear network management.
Instructions
Update properties of an adopted device — primarily for renaming. Use this to give devices self-documenting names following the {role}-{location} convention. Determine the role from the device's features array: switching+accessPoint (UDM/UDR/UXG combo) → gw, accessPoint only → ap, switching only → sw. Then append the physical location: gw-office, ap-living-room, sw-desk. Call list_devices or get_device first to check the current name and features. Uses the classic Network Application REST API (the integration API v1 does not support device updates).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>",
"deviceId": "<deviceId>"
},
"name": "manage_device"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Operation to perform | |
| deviceId | Yes | Device ID (UUID from list_devices) | |
| name | No | Device name. Convention: {role}-{location}, e.g. 'gw-office', 'ap-living-room', 'sw-desk' |