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

# Manage Team Members

> Invite users and manage access to Gradial's AI agent platform. Control roles and workspace permissions for your content team.

> **Note:** For details on what each role can do, see [Roles & Permissions](https://docs.gradial.com/docs/integrations-administration-and-setup/managing-access/roles).

***

## Inviting Users to Your Organization

Before someone can access Gradial, they must be invited to your organization.

### Steps

1. Navigate to [app.gradial.com](http://app.gradial.com)
2. Click **Settings** in the bottom-left corner of the navigation panel
3. Select **People** under the Organization section
4. Click the **Invite** button in the top-right corner
5. Enter the team member's **email address**
6. Select an **organization role** (Admin, Member, or Viewer)
7. Optionally assign **additional access** (Brand Manager, Designer) — these add permissions on top of the primary role
8. Click **Send Invitation**

### What Happens Next (For the Invited User)

The onboarding experience depends on your organization's authentication method:

**Username/Password Authentication**

* The invited user receives an email notification
* They must click the link and reset their password to activate their account
* After setting their password, they can log in at [app.gradial.com](http://app.gradial.com)

**Single Sign-On (SSO)**

* No password reset is required
* The user can log in immediately using your organization's SSO provider
* The invitation email serves as a notification only

***

## Granting Workspace Access

After a user joins your organization, you control which workspaces they can access.

**Important:** Organization Owners and Organization Admins automatically have access to all standard workspaces. You only need to manually add Members and Viewers.

### Public vs. Private Workspaces

* **Public workspaces** — All organization members and viewers have automatic access (members as Workspace Members, viewers as Workspace Viewers)
* **Private workspaces** — Access requires direct membership, an assigned [custom group](/docs/integrations-administration-and-setup/managing-access/groups), or a [SCIM group mapping](/docs/integrations-administration-and-setup/managing-access/scim)

> **Tip:** When the same people need access to several workspaces, create a [custom group](/docs/integrations-administration-and-setup/managing-access/groups#granting-workspace-access-with-groups) and assign it to each workspace instead of adding people one at a time.

### Adding a User to a Workspace

1. From the left navigation, select the workspace
2. Click **Settings** in the top-right corner
3. Select **Access Control**
4. Click **Add Members**
5. Search for the user by name or email
6. Select a **workspace role**
7. Click **Add**

A confirmation message will appear: "Access settings updated successfully."

***

## Common Tasks

### Changing a User's Organization Role

1. Go to **Settings → People** (Members tab)
2. Find the user in the list
3. Use the **Role** dropdown to select a new **Primary role**, and optionally toggle **Additional access** (Brand Manager, Designer)
4. Changes apply immediately across the organization

> **Tip:** The **Roles** tab on the People page shows every role and its current members, searchable and filterable by scope.

### Changing a User's Workspace Role

1. Open the workspace and go to **Settings → Access Control**
2. Find the user in the member list
3. Use the **Role** dropdown to change their workspace role
4. Changes apply only within that workspace

### Removing a User from a Workspace

1. Open the workspace and go to **Settings → Access Control**
2. Find the user in the member list
3. Click the remove option next to their name

***


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