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

# Users & Roles

> Manage team members, define roles with granular permissions, and handle invitations.

Users & Roles lets you control who has access to your organisation and what they can do. Access this section from Organisation settings → Users & Roles.

## Users

View and manage all users in your organisation.

### User information

| Column  | Description                               |
| ------- | ----------------------------------------- |
| Name    | User's email or display name              |
| Type    | User type (Self, Member, Service Account) |
| Status  | Account status (active, pending)          |
| Roles   | Assigned organisation-wide roles          |
| Actions | Edit or remove user                       |

### Inviting users

1. Click "Invite users"
2. Enter email addresses (multiple supported)
3. Click Invite

Invited users receive an email with instructions to join.

### Service accounts

Service accounts enable programmatic API access without user credentials.

1. Click "Create service account"
2. Configure the account name and permissions
3. Store the generated credentials securely

## Roles

Roles define what actions users can perform across projects.

### Creating a role

1. Go to Users & Roles → Roles tab
2. Click "Create role"
3. Configure the role settings

### Role configuration

| Field        | Description                                               |
| ------------ | --------------------------------------------------------- |
| Name         | Role identifier                                           |
| Description  | Purpose of the role                                       |
| IdP Groups   | SSO/SAML group mappings (e.g., `TECH-leads, BA_analysts`) |
| Users        | Assign specific users to this role                        |
| All projects | Toggle to apply role to all projects                      |
| Projects     | Select specific projects (when "All projects" is off)     |

### Permission categories

**Project-level permissions:**

| Permission     | Description                                       |
| -------------- | ------------------------------------------------- |
| Project Admin  | Full project access                               |
| Project Manage | Members, groups, tokens, approvers, configuration |

**Documents (v1 projects):**

| Permission   | Description                                                |
| ------------ | ---------------------------------------------------------- |
| Full         | Create, update, delete, move, copy, restore, graph content |
| Edit Content | Update graph content                                       |
| View Content | View graph content only                                    |
| Edit View    | Update view content only                                   |

**Branches (v2 projects):**

| Permission | Description         |
| ---------- | ------------------- |
| Create     | Create new branches |
| Merge      | Merge branches      |
| Delete     | Delete branches     |

**Releases:**

| Permission | Description                     |
| ---------- | ------------------------------- |
| Manage     | Create and edit releases        |
| Deploy     | Deploy releases to environments |
| Delete     | Remove releases                 |

**Environments:**

| Permission | Description                         |
| ---------- | ----------------------------------- |
| Manage     | Create, update, configure approvers |
| Delete     | Remove environments                 |

### File permissions

Add granular permissions for specific files or paths within projects.

## Invitations

Track pending and accepted invitations.

### Pending tab

View invitations awaiting user acceptance. Resend or cancel invitations as needed.

### Accepted tab

View historical record of accepted invitations.