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

# Managing Users

> Invite team members, manage organization membership, and organize users into groups.

Brainstormer organizations support multiple users with different roles and permissions. You can invite colleagues, organize them into groups, and control exactly what each person can access.

## Inviting Members

To invite someone to your organization:

<Steps>
  <Step title="Go to team settings">
    Navigate to **Settings** in the sidebar, then select the **Team** section.
  </Step>

  <Step title="Send an invitation">
    Click **Invite Member** and enter:

    * **Email address** — The person's email
    * **Role** — The role to assign (member is the default)

    An invitation email is sent with a link to accept and join the organization.
  </Step>

  <Step title="Member accepts">
    The invited person clicks the link in the email, creates an account (or logs in if they already have one), and joins your organization.
  </Step>
</Steps>

<Info>
  If the email service (Resend) is not configured, invitation details are logged to the console. In production, invitations are sent via email automatically.
</Info>

## Managing Members

From the **Team** page in Settings, you can:

* **View all members** — See everyone in your organization with their role and join date
* **Change roles** — Promote or demote members (requires admin or owner role)
* **Remove members** — Remove someone from the organization
* **Suspend members** — Temporarily disable access without removing them

## User Groups

Groups let you organize members into teams and assign permissions in bulk rather than individually.

### Creating Groups

1. Navigate to **Settings > Groups**.
2. Click **Create Group**.
3. Enter a group name and optional description (e.g., "Marketing Team", "Support Staff").
4. Add members to the group.

### Default Groups

You can mark a group as the **default group**. New members who join the organization are automatically added to the default group, inheriting its permissions.

### Group Permissions

Instead of assigning permissions to individual users, assign them to groups:

* Give the "Marketing" group access to the "Brand Bot" agent
* Give the "Support" group access to the "Customer FAQ" knowledge base
* Give the "Analytics" group permission to view organization-wide analytics

When a user is added to a group, they immediately inherit all of that group's permissions. When removed, those permissions are revoked.

<Tip>
  Groups are the most efficient way to manage permissions at scale. Instead of updating permissions for 20 individual users when a new agent is created, add permissions to the group once and all members get access.
</Tip>

## Member Roles

Each member has one of four organization roles:

| Role       | Access Level                                                                               |
| ---------- | ------------------------------------------------------------------------------------------ |
| **Owner**  | Full control over the organization, including billing, settings, and deletion              |
| **Admin**  | Manage org settings, members, agents, and KBs — everything except billing and org deletion |
| **Member** | Use agents and KBs they have permission for; cannot manage settings or invite others       |
| **Viewer** | Read-only access to resources they have been explicitly granted access to                  |

See [Roles and Permissions](/platform-guide/users-orgs/roles-permissions) for a detailed breakdown of what each role can do.

## Multi-Organization Support

Users can belong to multiple organizations. Each organization is an independent workspace with its own:

* Agents and knowledge bases
* Members and permissions
* Billing and credit wallet
* Settings and configuration

Users switch between organizations using the **Organization Switcher** in the sidebar.

<Note>
  A user's role can differ between organizations. You might be an owner of your personal workspace and a member of your company's workspace.
</Note>

## Audit Trail

All user management actions are logged in the audit trail:

* Member invitations sent and accepted
* Role changes
* Member removals and suspensions
* Group creation and membership changes
* Permission grants and revocations

Organization admins and owners can view the audit log from **Settings > Audit Log**.