Skip to main content

How Permissions Work

The Reelevant platform uses a role-based access control (RBAC) system. Every user is assigned exactly one role that defines what they can do and which resources they can interact with. Resources are further scoped by teams so that users only see what belongs to their teams. The permission evaluation follows three layers:
  1. Role — Defines which actions the user can perform on which resource types.
  2. Company — Every permission rule is automatically scoped to the user’s company, ensuring complete tenant isolation.
  3. Team (Resource Group) — For team-scoped resources, the user can only access resources that belong to one of their teams.
Every user automatically has permission to read and update their own profile, regardless of their role configuration. These built-in rules cannot be removed.

Resources

Resources represent the different entities you can manage on the platform. Each resource supports a specific set of actions.
ResourceDescriptionScoping
WorkflowWorkflow creation and management.Company + Team
Workflow SettingsGlobal workflow configuration (variable profiles, etc.).Company
ContentContent template creation and management.Company + Team
DatasourceDatasource creation and management.Company + Team
StatisticsAnalytics data access and export.Company
UserUser account management (invite, edit, delete).Company
RoleRole creation and management.Company
Teams (Resource Group)Team creation and management.Company
CompanyCompany-level settings and configuration.Company
BillingBilling and subscription access.Company
InvitationUser invitation management.Company
Datagraph SchemaDatagraph schema definition and management.Company + Team
Datagraph EntityDatagraph entity data access and management.Company + Team

Resource Scoping

Resources fall into two categories based on how access is controlled:
These resources are shared across the entire company. Any user with the appropriate role permission can access them, regardless of which team they belong to.Company-scoped resources: User, Role, Teams, Company, Billing, Invitation, Workflow Settings, Statistics.
These resources belong to one or more teams. A user can only access a team-scoped resource if they are a member of (or inherit access to) one of the resource’s teams.Team-scoped resources: Workflow, Content, Datasource, Datagraph Schema, Datagraph Entity.For example, if a workflow is assigned to the “Marketing” team, only users who are members of “Marketing” (or one of its ancestor teams) can interact with that workflow — provided their role grants the required action.

Actions

Actions define what operations a user can perform on a given resource. Not every action is available for every resource — the permissions matrix shows the full mapping.
ActionDescription
AccessPermission to view the resource section in the navigation.
CreatePermission to create new instances of the resource.
ReadPermission to view resource details.
QueryPermission to search and list resources.
UpdatePermission to modify existing resources.
DeletePermission to remove resources.
ExportPermission to export resource data.

Permissions Matrix

The table below shows which actions are available for each resource. When configuring a role, you can toggle each available action individually.
ResourceAccessCreateReadQueryUpdateDeleteExport
Datasource
Workflow
Content
Workflow Settings
Statistics
User
Role
Teams
Company
Billing
Invitation
Datagraph Schema
Datagraph Entity
The Access action controls whether the section appears in the platform navigation. For example, granting Statistics → Access makes the Analytics section visible to the user.

Permission Evaluation

When a user tries to perform an action, the system checks the following conditions in order:
1

Role check

Does the user’s role include a rule granting the requested action on the target resource type?
2

Company check

Does the target resource belong to the same company as the user? This check is automatic and ensures complete tenant isolation.
3

Team check (team-scoped resources only)

Is the user a member of at least one team that the target resource belongs to? Team membership includes inherited access from the team hierarchy.
If any check fails, the action is denied with a 403 Forbidden error.

Synced Resources

Some resources are automatically linked so their permissions stay in sync:
When you grant a permission on…The same permission is also granted on…
ContentContent Font Resources
DatasourceOAuth Clients
These synced resources are not shown in the role editor — they are managed automatically.

Built-in Rules

Every role includes two rules that cannot be removed:
RuleEffect
Read own profileEvery user can view their own user profile.
Update own profileEvery user can edit their own profile (name, password, 2FA, preferences).
These rules are scoped to the individual user and do not grant access to other users’ profiles.

Common Configurations

An admin role typically grants all actions on all resources. This gives full control over the platform, including user management, billing, and company settings.
An editor role typically grants create, read, update, and delete on Workflow, Content, and Datasource — plus read access to Statistics. This lets the user build and manage campaigns without access to account administration.
A viewer role typically grants only read and access actions. Users can browse workflows, contents, and analytics dashboards but cannot make changes.