Roles & Permissions

Guidebook Cloud uses a role-based access control system. Each member has a role that determines what they can do within the organization.

Role Hierarchy

Roles are hierarchical, with higher roles having all permissions of lower roles:

Owner > Admin > Member

Role Details

Owner

The organization owner has full control:

  • All Admin permissions
  • Remove other admins and members
  • Delete the organization

There is exactly one owner per organization. Ownership transfer is not currently supported.

Admin

Administrators can manage most organization resources:

  • Manage repositories and settings
  • Configure access rules
  • Trigger and cancel builds
  • Invite admins and members
  • Manage teams

Member

Members have view-only access:

  • Can only view repositories and teams assigned via team membership
  • Cannot view all organization repositories by default
  • Cannot create or modify resources

Permission Matrix

PermissionOwnerAdminMember
View repositoriesYesYesTeam only
Create repositoriesYesYesNo
Delete repositoriesYesYesNo
Configure repositoriesYesYesNo
Manage GitHub integrationYesYesNo
Trigger buildsYesYesNo
View buildsYesYesNo
Configure access rulesYesYesNo
View team membersYesYesNo
Invite membersYesYesNo
Remove membersYesNoNo
Edit member rolesYesNoNo
Create teamsYesYesNo
Manage teamsYesYesNo
View organization settingsYesYesNo
Edit organization settingsYesYesNo
Delete organizationYesNoNo

Changing Roles

Only the Owner can change member roles:

  1. Go to Team Members
  2. Find the member
  3. Click Edit
  4. Select the new role
  5. Click Save Changes

Choosing the Right Role

Use Member for:

  • Regular team members
  • Developers who need to view specific documentation
  • Users who don't need management access
  • External contractors with limited access needs

Use Admin for:

  • Team leads
  • DevOps engineers managing deployments
  • Users who need to manage repositories and access

Keep Owner for:

  • Primary account holder
  • Final authority for organization decisions