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

# Members & Permissions

> Manage workspace members and their access levels

## Workspace Roles

Every workspace member has one of four roles. Roles determine what actions a member can perform within the workspace.

| Role       | View Conversations | Send Messages | Upload Files | Manage Members | Delete Workspace |
| ---------- | :----------------: | :-----------: | :----------: | :------------: | :--------------: |
| **Owner**  |         Yes        |      Yes      |      Yes     |       Yes      |        Yes       |
| **Admin**  |         Yes        |      Yes      |      Yes     |       Yes      |        No        |
| **Member** |         Yes        |      Yes      |      Yes     |       No       |        No        |
| **Viewer** |         Yes        |       No      |      No      |       No       |        No        |

<Note>
  Every workspace has exactly one Owner. Ownership can be transferred but not shared. See [Transferring Ownership](#transferring-ownership) below.
</Note>

### Role Details

* **Owner** -- Full control over the workspace. Can invite and remove members, change roles, manage files, delete the workspace, and transfer ownership. The person who creates a workspace is automatically the Owner.
* **Admin** -- Can do everything the Owner can except delete the workspace or transfer ownership. Admins can invite new members, approve access requests, and remove non-admin members.
* **Member** -- Can participate in conversations, upload files, and view all workspace content. Cannot manage other members or change workspace settings.
* **Viewer** -- Read-only access. Viewers can see conversations and files but cannot send messages or upload documents. Useful for stakeholders who need visibility without active participation.

## Inviting Members

<Steps>
  <Step title="Open the Members tab">
    Navigate to your workspace and click the **Members** tab.
  </Step>

  <Step title="Click Invite">
    Click the **Invite** button. Enter the email address of the person you want to add. They must already have a RelayHub account in your organization.
  </Step>

  <Step title="Assign a role">
    Select the role for the new member: Admin, Member, or Viewer. You can change this later.
  </Step>

  <Step title="Send the invitation">
    Click **Send Invite**. The user will see the workspace in their Workspaces list immediately.
  </Step>
</Steps>

<Tip>
  You can invite multiple people at once. Each person can be assigned a different role during the invitation flow.
</Tip>

## Access Request Workflow

Users who are not members of a workspace can request access to it. This is useful when someone discovers a workspace through a shared link or sees it referenced in a conversation.

<Tabs>
  <Tab title="Requesting Access">
    1. Navigate to the workspace you want to join.
    2. Click **Request Access**. You can optionally include a message explaining why you need access.
    3. Your request is sent to the workspace Owner and Admins for review.
    4. You will be notified when your request is approved or denied.
  </Tab>

  <Tab title="Approving / Denying Requests">
    1. Owners and Admins receive a notification when a new access request arrives.
    2. Open the **Members** tab and look for the **Pending Requests** section.
    3. For each request, review the requester's name and message, then click **Approve** or **Deny**.
    4. When approving, select the role to assign (Member is the default).
  </Tab>
</Tabs>

## Changing a Member's Role

Owners and Admins can change the role of any member below their own level. Open the **Members** tab, find the member, and click the role dropdown to select a new role.

<Warning>
  Promoting a Member to Admin gives them the ability to manage other members, including removing existing Members. Be intentional about Admin promotions.
</Warning>

## Removing Members

Owners and Admins can remove members from the workspace. Open the **Members** tab, find the member, and click **Remove**. Removed members immediately lose access to all workspace conversations, files, and memory.

## Transferring Ownership

The current Owner can transfer ownership to another member of the workspace.

<Steps>
  <Step title="Open the Members tab">
    Navigate to the workspace and click the **Members** tab.
  </Step>

  <Step title="Select the new Owner">
    Find the member you want to promote. Click the options menu and select **Transfer Ownership**.
  </Step>

  <Step title="Confirm the transfer">
    Confirm the action. You will be demoted to Admin, and the selected member becomes the new Owner.
  </Step>
</Steps>

<Warning>
  Ownership transfer is immediate and cannot be undone by the previous Owner. The new Owner must transfer it back if needed.
</Warning>

<Card title="Next: Workspace Files" icon="arrow-right" href="/workspaces/files" horizontal>
  Learn how to upload, manage, and reindex files in your workspace.
</Card>