Skip to main content
A group is a hierarchical organizational unit for devices, allowing you to organize devices into a logical tree structure. Groups can contain both devices and subgroups. Devices may be assigned to at most one group, or be unassigned to any group.

​
Properties

​
name
string
A human-readable display name for the group. Must be unique within the workspace.Examples: Production, Warehouse Floor 2, Europe
​
parent
Group
The parent group in the hierarchy. Set to null for top-level groups; set to another group’s ID to nest this group as a child group.Examples: grp_123, null
​
devices
[]Device
The devices assigned to this group. Computed by the server—useful for determining whether to display device-related affordances in the UI.
​
subgroups
[]Group
The child subgroups within this group. Computed by the server—useful for rendering expand/collapse indicators in a tree view.

​
Structure

Groups organize devices into a tree hierarchy. A workspace can have multiple top-level groups, and each group can contain subgroups.
Workspace
Production
North America
Device A
Device B
Europe
Device C
Staging
Device D
Device E (unassigned)
Devices belong to at most one group. Devices that haven’t been assigned to any group remain ungrouped at the workspace level.
Last modified on June 16, 2026