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 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.
| 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
- Click “Invite users”
- Enter email addresses (multiple supported)
- Click Invite
Invited users receive an email with instructions to join.
Service accounts
Service accounts enable programmatic API access without user credentials.
- Click “Create service account”
- Configure the account name and permissions
- Store the generated credentials securely
Roles
Roles define what actions users can perform across projects.
Creating a role
- Go to Users & Roles → Roles tab
- Click “Create role”
- 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.