> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threetone.in/llms.txt
> Use this file to discover all available pages before exploring further.

# User groups

> Create and maintain workspace groups, review membership, and distinguish group access from billing allocation.

User groups organize workspace members so you can review team membership and share eligible resources with several people together. They do not create billing groups or substitute for workspace membership.

You need permission to manage groups and existing members to add. System groups and directory-managed or frozen groups are not editable through the manual group controls.

<Steps>
  <Step title="Create a manual group" id="user-groups-create">
    Open [Workspace > Groups](https://threetone.in/app/workspace/groups). Select **Create group**, enter a **Group name**, and save it. Choose a name that describes a team or responsibility. Names must contain 1 to 100 characters.
  </Step>

  <Step title="Review membership" id="user-groups-members">
    Open the group's **Manage Group** action and review **Members**. Member selections issue their own add or remove requests. Use **Save changes** for a renamed group, then reopen it to verify the result.
  </Step>

  <Step title="Inspect permissions and resource grants" id="user-groups-access">
    **Manage Access** displays currently assigned permissions; it is a read-only view. Use the supported [resource-sharing workflow](/overview/administration/workspaces/sharing-resources) for an eligible resource grant.
  </Step>
</Steps>

The API supports [list](/api-reference/workspace/list-workspace-groups), [create](/api-reference/workspace/create-workspace-group), update, delete, and membership operations. Creation requires an `Idempotency-Key`. Preserve it when retrying the same request after an uncertain outcome; changing the request requires a new key.

Review affected resource access before removing members or deleting a group. A directory badge identifies management metadata, not proof of a complete [SCIM deployment](/overview/administration/workspaces/sso).

<AccordionGroup>
  <Accordion title="Does Create group invite new people?" id="user-groups-faq-invite">No. Add existing workspace members, and use the separate invitation workflow for new members.</Accordion>
  <Accordion title="Can I change every group from the dashboard?" id="user-groups-faq-managed">No. System, directory-managed, and frozen groups have restricted manual controls. Review their management source first.</Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.