Device Groups
Tools for organizing devices into folders (groups). Groups form a hierarchy with optional parent-child nesting.
list_device_groups
List all device groups used to organize devices in the account. Returns group objects with id, name, and parent_id.
Parameters: None
get_device_group
Get details of a specific device group including its name, parent group reference, and child groups.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string | Yes | The device group ID |
create_device_group
Create a new device group for organizing devices.
| Parameter | Type | Required | Description |
|---|---|---|---|
name |
string | Yes | Name for the new group |
parent_id |
string | No | Parent group ID for nesting (omit for top-level) |
update_device_group
Update a device group’s name or parent assignment.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string | Yes | The device group ID |
name |
string | No | Updated group name |
parent_id |
string | No | New parent group ID |
delete_device_group
Delete a device group. Devices in the group will become ungrouped. This action cannot be undone.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string | Yes | The device group ID |