Skip to main content
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

ColumnDescription
NameUser’s email or display name
TypeUser type (Self, Member, Service Account)
StatusAccount status (active, pending)
RolesAssigned organisation-wide roles
ActionsEdit 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

FieldDescription
NameRole identifier
DescriptionPurpose of the role
IdP GroupsSSO/SAML group mappings (e.g., TECH-leads, BA_analysts)
UsersAssign specific users to this role
All projectsToggle to apply role to all projects
ProjectsSelect specific projects (when “All projects” is off)

Permission categories

Project-level permissions:
PermissionDescription
Project AdminFull project access
Project ManageMembers, groups, tokens, approvers, configuration
Documents (v1 projects):
PermissionDescription
FullCreate, update, delete, move, copy, restore, graph content
Edit ContentUpdate graph content
View ContentView graph content only
Edit ViewUpdate view content only
Branches (v2 projects):
PermissionDescription
CreateCreate new branches
MergeMerge branches
DeleteDelete branches
Releases:
PermissionDescription
ManageCreate and edit releases
DeployDeploy releases to environments
DeleteRemove releases
Environments:
PermissionDescription
ManageCreate, update, configure approvers
DeleteRemove 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.