Supercheck LogoSupercheck

Roles & Permissions

Role-based access control for organizations and projectsEdit

Supercheck uses a 6-role RBAC system with granular permissions across organizations and projects. This page provides a complete reference of what each role can do.

Role Overview

Access Scope: Organization-level roles (Super Admin, Org Owner, Org Admin) have access to all projects in the organization. Project-level roles (Project Admin, Project Editor) are limited to assigned projects only. Project Viewer has read-only access to all projects.

RoleLevelDescription
Super AdminSystemPlatform-wide control, user management, and impersonation
Org OwnerOrganizationFull organization control including deletion
Org AdminOrganizationOrganization management without deletion rights
Project AdminProjectFull control of assigned projects
Project EditorProjectCreate and edit resources in assigned projects
Project ViewerOrganizationRead-only access to all projects

Role Hierarchy

Loading diagram...

Permission Matrix

ResourceSuper AdminOrg OwnerOrg AdminProject AdminProject EditorProject Viewer
View organization✅✅✅✅✅✅
Update organization✅✅✅❌❌❌
Delete organization✅✅❌❌❌❌
Invite members✅✅✅❌❌❌
Manage members✅✅✅❌❌❌
Remove members✅✅✅❌❌❌
ResourceSuper AdminOrg OwnerOrg AdminProject Admin*Project Editor*Project Viewer
View projects✅✅✅✅✅✅
Create projects✅✅✅❌❌❌
Update projects✅✅✅✅❌❌
Delete projects✅✅✅❌❌❌
Manage project members✅✅✅✅❌❌

* Project Admin and Project Editor permissions apply only to their assigned projects.

ActionSuper AdminOrg OwnerOrg AdminProject Admin*Project Editor*Project Viewer
View✅✅✅✅✅✅
Create✅✅✅✅✅❌
Edit✅✅✅✅✅❌
Delete✅✅✅✅❌❌
Run/Trigger✅✅✅✅✅❌
ActionSuper AdminOrg OwnerOrg AdminProject Admin*Project Editor*Project Viewer
View✅✅✅✅✅✅
Create✅✅✅✅✅❌
Edit✅✅✅✅✅❌
Pause/Resume✅✅✅✅✅❌
Delete✅✅✅✅❌❌
ActionSuper AdminOrg OwnerOrg AdminProject Admin*Project Editor*Project Viewer
View✅✅✅✅✅✅
Cancel✅✅✅✅✅❌
Delete✅✅✅✅❌❌
ActionSuper AdminOrg OwnerOrg AdminProject Admin*Project Editor*Project Viewer
View✅✅✅✅✅❌
Create✅✅✅✅✅❌
Edit✅✅✅✅✅❌
Delete✅✅✅✅❌❌
ActionSuper AdminOrg OwnerOrg AdminProject Admin*Project Editor*Project Viewer
View✅✅✅✅✅✅
Create✅✅✅✅✅❌
Edit✅✅✅✅✅❌
Delete✅✅✅✅❌❌
ActionSuper AdminOrg OwnerOrg AdminProject Admin*Project Editor*Project Viewer
View✅✅✅✅✅✅
Create✅✅✅✅✅❌
Edit✅✅✅✅✅❌
Delete✅✅✅✅❌❌
ActionSuper AdminOrg OwnerOrg AdminProject Admin*Project Editor*Project Viewer
View services & incidents✅✅✅✅✅✅
Create & update services✅✅✅✅✅❌
Delete services✅✅✅✅❌❌
Create & update incidents✅✅✅✅✅❌
Delete incidents✅✅✅✅❌❌
Investigate stored evidence✅✅✅✅✅❌
Configure & investigate live connectors✅✅✅✅❌❌
Approve topology suggestions✅✅✅✅❌❌

* Project Admin and Project Editor permissions apply only to their assigned projects. Project Editors can investigate stored evidence and manage incidents, but cannot query or configure live external connectors (sre_connector:investigate).

Variables & Secrets

Variables and secrets have special permission rules to balance usability with security.

ActionSuper AdminOrg OwnerOrg AdminProject Admin*Project Editor*Project Viewer
View variables✅✅✅✅✅✅
Create variables✅✅✅✅✅❌
Edit variables✅✅✅✅✅❌
Delete variables✅✅✅✅❌❌
View secret values✅✅✅✅✅❌

Project Editors can create/edit variables and view decrypted secret values (needed to use secrets in tests), but cannot delete variables. This prevents accidental data loss while allowing productive work with encrypted secrets.

System Administration

These permissions are exclusive to Super Admin users:

CapabilityDescription
User ManagementView, ban, and unban any user
User ImpersonationLog in as any user for troubleshooting
View All OrganizationsAccess any organization's data
Queue MonitoringView and manage BullMQ job queues
System StatisticsView platform-wide metrics

Access Scope Details

Organization-Wide Access

The following roles can access all projects in their organization without explicit assignment:

  • Super Admin — All organizations, all projects
  • Org Owner — All projects in owned organizations
  • Org Admin — All projects in administered organizations
  • Project Viewer — Read-only access to all projects (intentional for monitoring roles)

Project-Limited Access

These roles only have access to explicitly assigned projects:

  • Project Admin — Full control, but only for assigned projects
  • Project Editor — Create/edit permissions, but only for assigned projects

Why is Project Viewer organization-wide? This design enables oversight and monitoring roles to view all projects without needing individual assignments. They cannot modify anything, making it safe for read-only visibility.

Quick Reference

If you need to...Minimum Role Required
View tests and runsProject Viewer
Run tests manuallyProject Editor
Create new testsProject Editor
Delete testsProject Admin
Invite team membersOrg Admin
Delete the organizationOrg Owner
Ban/unban usersSuper Admin

On this page