> ## 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.


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