Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mirurobotics.com/llms.txt

Use this file to discover all available pages before exploring further.

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 are unassigned to a group.
Since group operations are a critical primitive to organizing your workspace, they are only available to .

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.

Create a group

Go to the Groups page and navigate into the group you want to create a group inside of. Ensure you’re within the Groups tab for the group you’re inside of and click the + Group button in the top right corner.
Group Page
Fill in the fields, then click Create.
Create Group Dialog

Edit a group

Navigate to the Groups page, click the ellipses (…) on the group you want to edit, and hit Edit.
Group Ellipses Dropdown
Update the desired fields, then click Save.
Edit Group Dialog

Move a device

To move a device to a different group, click the ellipses (…) on the device you want to move and select Move.
Device Ellipses Dropdown
A dialog will appear—select the group you want to move the device to and hit Move.
Move Device Dialog

Delete a group

A group can only be deleted if it has no subgroups and no assigned devices. If you need to delete a group that still contains devices or subgroups, first move or reassign its contents. To delete a group, click the ellipses (…) on the group you want to delete and select Delete.
Group Ellipses Dropdown
A confirmation dialog will appear. Hit Delete to confirm the deletion.
Delete Group Dialog
Last modified on May 28, 2026