> ## 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.

# Manage groups

export const GroupManagerBadge = ({size = "md"}) => {
  return <Tooltip tip="Members who are managers of a group that contains this resource can execute this action." cta="Workspace roles" href="/admin/users/access-control">
            <Badge icon="group" color="blue" size={size}>group manager</Badge>
        </Tooltip>;
};

export const AdminBadge = ({size = "md"}) => {
  return <Tooltip tip="Workspace owners and administrators can execute this action." cta="Workspace roles" href="/admin/users/access-control">
            <Badge icon="shield-check" color="blue" size={size}>admin</Badge>
        </Tooltip>;
};

export const PlatformUnsupportedBadge = () => {
  return <Tooltip tip="Platform API does not support this operation">
      <span className="inline-flex items-center gap-1.5 rounded-lg px-2 py-0.5 text-sm text-[rgb(var(--gray-500))] dark:text-[rgb(var(--gray-400))]" style={{
    marginLeft: '-0.5rem',
    cursor: 'default'
  }}>
        <Icon icon="ban" size={13} color="currentColor" /> Platform API
      </span>
    </Tooltip>;
};

export const PlatformApiLink = ({endpoint, newTab, children}) => {
  const href = `/references/platform-api/2026-08-17/endpoints/${endpoint}`;
  if (newTab) {
    return <a href={href} target="_blank" rel="noopener noreferrer">{children}</a>;
  }
  return <a href={href}>{children}</a>;
};

export const PlatformApiBadge = ({endpoint, label = "Platform API"}) => {
  const href = `/references/platform-api/2026-08-17/endpoints/${endpoint}`;
  return <Tooltip tip="Open the Platform API reference for this operation">
      <a href={href} target="_blank" rel="noopener noreferrer" style={{
    textDecoration: 'none',
    borderBottom: 'none'
  }}>
        <span className="inline-flex items-center gap-1.5 rounded-lg px-2 py-0.5 text-sm text-[rgb(var(--gray-500))] dark:text-[rgb(var(--gray-400))] hover:bg-[rgb(var(--gray-100))] dark:hover:bg-[rgb(var(--gray-800))] hover:text-[rgb(var(--gray-700))] dark:hover:text-[rgb(var(--gray-200))]" style={{
    marginLeft: '-0.5rem'
  }}>
          {label} <Icon icon="arrow-up-right" size={13} color="currentColor" />
        </span>
      </a>
    </Tooltip>;
};

## View a group

<PlatformApiBadge endpoint="groups/get" />

To view your workspace's groups, navigate to the [Groups page](https://app.mirurobotics.com/groups).

## Create a group  <AdminBadge />  <GroupManagerBadge />

<PlatformApiBadge endpoint="groups/create" />

Go to the [Groups page](https://app.mirurobotics.com/groups) and navigate into the group you want to create a group inside of. Click the **+ Group** button in the top right corner.

<Frame>
  ![Group Page](https://assets.mirurobotics.com/docs/v04/images/groups/page.png)
</Frame>

Fill in the fields, then click **Create**.

<Frame>
  ![Create Group Dialog](https://assets.mirurobotics.com/docs/v04/images/groups/create-dialog.png)
</Frame>

## Edit a group  <AdminBadge />  <GroupManagerBadge />

<PlatformApiBadge endpoint="groups/update" />

Navigate to the [Groups page](https://assets.mirurobotics.com/docs/v04/images/groups/page.png), click the ellipses (...) on the group you want to edit, and hit **Edit**.

<Frame>
  ![Group Ellipses Dropdown](https://assets.mirurobotics.com/docs/v04/images/groups/ellipses-dropdown.png)
</Frame>

Update the desired fields, then click **Save**.

<Frame>
  ![Edit Group Dialog](https://assets.mirurobotics.com/docs/v04/images/groups/edit-dialog.png)
</Frame>

## Move a group  <AdminBadge />  <GroupManagerBadge />

<PlatformApiBadge endpoint="groups/move" />

To move a group to a new parent group—or to the top level by setting `parent_id` to `null`—use the <PlatformApiLink endpoint="groups/move">move group endpoint »</PlatformApiLink>

## Move a device  <AdminBadge />  <GroupManagerBadge />

<PlatformUnsupportedBadge />

To move a device to a different group, click the ellipses (...) on the device you want to move and select **Move**.

<Frame>
  ![Device Ellipses Dropdown](https://assets.mirurobotics.com/docs/v04/images/groups/device-ellipses-dropdown.png)
</Frame>

A dialog will appear—select the group you want to move the device to and hit **Move**.

<Frame>
  ![Move Device Dialog](https://assets.mirurobotics.com/docs/v04/images/groups/move-device-dialog.png)
</Frame>

## Delete a group  <AdminBadge />  <GroupManagerBadge />

<PlatformUnsupportedBadge />

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**.

<Frame>
  ![Group Ellipses Dropdown](https://assets.mirurobotics.com/docs/v04/images/groups/ellipses-dropdown.png)
</Frame>

A confirmation dialog will appear. Hit **Delete** to confirm the deletion.

<Frame>
  ![Delete Group Dialog](https://assets.mirurobotics.com/docs/v04/images/groups/delete-dialog.png)
</Frame>
