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

# Roles

> User role definitions for workspace access control and permission management

User roles define the permissions and access levels within a workspace. These roles control what actions users can perform and what content they can access.

## Available Roles

<div className="grid grid-cols-1 md:grid-cols-2 gap-6">
  <div className="border rounded-lg p-4">
    <h3 className="text-lg font-semibold text-blue-600 mb-2">admin</h3>
    <p className="text-gray-600 mb-3">Full administrative access</p>

    <ul className="list-disc list-inside text-sm space-y-1">
      <li>Manage users and permissions</li>
      <li>Configure workspace settings</li>
      <li>Access all workspace content</li>
      <li>Manage integrations and billing</li>
    </ul>
  </div>

  <div className="border rounded-lg p-4">
    <h3 className="text-lg font-semibold text-green-600 mb-2">member</h3>
    <p className="text-gray-600 mb-3">Standard user access</p>

    <ul className="list-disc list-inside text-sm space-y-1">
      <li>Create and edit own content</li>
      <li>Collaborate on shared projects</li>
      <li>View workspace content</li>
      <li>Limited administrative actions</li>
    </ul>
  </div>

  <div className="border rounded-lg p-4">
    <h3 className="text-lg font-semibold text-purple-600 mb-2">owner</h3>
    <p className="text-gray-600 mb-3">Ultimate ownership permissions</p>

    <ul className="list-disc list-inside text-sm space-y-1">
      <li>All admin rights</li>
      <li>Delete workspace</li>
      <li>Transfer ownership</li>
      <li>Billing and subscription management</li>
    </ul>
  </div>

  <div className="border rounded-lg p-4">
    <h3 className="text-lg font-semibold text-orange-600 mb-2">guest</h3>
    <p className="text-gray-600 mb-3">Limited read-only access</p>

    <ul className="list-disc list-inside text-sm space-y-1">
      <li>View shared content only</li>
      <li>Read-only permissions</li>
      <li>External collaborator access</li>
      <li>Time-limited access (optional)</li>
    </ul>
  </div>
</div>

## Role Comparison Table

<div className="overflow-x-auto">
  <table>
    <thead>
      <tr>
        <th>Role</th>
        <th>Description</th>
        <th>User Management</th>
        <th>Content Access</th>
        <th>Workspace Settings</th>
        <th>Billing & Deletion</th>
      </tr>
    </thead>

    <tbody>
      <tr>
        <td>
          <strong className="text-purple-600">owner</strong>
        </td>

        <td>Ultimate ownership permissions</td>
        <td>✅ Full control</td>
        <td>✅ All content</td>
        <td>✅ All settings</td>
        <td>✅ Delete workspace</td>
      </tr>

      <tr>
        <td>
          <strong className="text-blue-600">admin</strong>
        </td>

        <td>Full administrative access</td>
        <td>✅ Manage users</td>
        <td>✅ All content</td>
        <td>✅ All settings</td>
        <td>⚠️ Billing only</td>
      </tr>

      <tr>
        <td>
          <strong className="text-green-600">member</strong>
        </td>

        <td>Standard user access</td>
        <td>❌ No access</td>
        <td>⚠️ Own + shared</td>
        <td>❌ Limited</td>
        <td>❌ No access</td>
      </tr>

      <tr>
        <td>
          <strong className="text-orange-600">guest</strong>
        </td>

        <td>Limited read-only access</td>
        <td>❌ No access</td>
        <td>⚠️ Shared only</td>
        <td>❌ No access</td>
        <td>❌ No access</td>
      </tr>
    </tbody>
  </table>
</div>

## Role Hierarchy

The roles follow a hierarchical structure where higher-level roles inherit permissions from lower levels:

```
owner > admin > member > guest
```

## Usage in API

When creating or updating memberships, use these exact role values:

```json theme={null}
{
  "role": "admin"
}
```

**Valid values:** `admin`, `member`, `owner`, `guest`