Skip to main content

Permission Matrix — Tenant-Wide Default Permissions

Access: Tenant Admins only

The Permission Matrix gives you a bird's-eye view of all platform sections and their default access settings. Use it to configure what new users get by default when they join your workspace.


What is the Permission Matrix?

When you invite a new Tenant User, their section access is initialized based on tenant-wide defaults. The Permission Matrix is where you configure these defaults.

Permission Matrix View — Replace with actual screenshot

Why it matters:

  • Without defaults, you'd have to manually configure every section for every new user
  • Good defaults save time and ensure consistency
  • You can always override defaults for individual users later

How to Access the Permission Matrix

Navigate to Access ManagementPermission Matrix tab.


What You'll See

The matrix displays all 13 platform sections in a table:

SectionTypeConfigurable?What It Means
Access ManagementAdmin onlyNoOnly Tenant Admins can access. Cannot be toggled for users.
AgentsConfigurableYesCan be enabled/disabled per user. New users get the default setting.
TracesConfigurableYesSame as above
LogsConfigurableYesSame as above
EvalConfigurableYesSame as above
SessionConfigurableYesSame as above
PromptsConfigurableYesSame as above
AnalyticsAdmin onlyNoOnly Tenant Admins can access
Cost ControlAdmin onlyNoOnly Tenant Admins can access
IntelligenceAlways accessibleNoAll users can access — no toggle needed
AnalyserAlways accessibleNoAll users can access — no toggle needed
AgentGuardAdmin onlyNoOnly Tenant Admins can access
MCP DebugConfigurableYesCan be enabled/disabled per user

Configuring Defaults

For each configurable section, you can set two properties:

PropertyWhat It Does
ConfigurableWhether the section can be toggled per user (this is set at the global level and typically doesn't change)
Default AllowedWhether the section is enabled by default for newly invited Tenant Users

How to change defaults:

  1. Find the configurable section in the matrix.
  2. Toggle the Default Allowed setting.
  3. The change applies to new users only — existing users' settings are not affected.

How It Differs from Section Access

These two features work together but serve different purposes:

FeaturePermission MatrixSection Access
What it configuresTenant-wide defaultsPer-user overrides
Who it affectsNew users joining the workspaceIndividual existing users
Where to find itAccess Management → Permission MatrixAccess Management → User row → Slider icon
Admin-only sectionsShown (read-only, for reference)Not shown (cannot be toggled for users)

Recommended workflow:

  1. First, set your Permission Matrix defaults to match what most users need.
  2. Then, invite users — they'll get the defaults automatically.
  3. Finally, fine-tune individual users' access via Section-Level Access if needed.

Example Default Configurations

"Give everyone full access by default"

Enable Default Allowed for all configurable sections (Agents, Traces, Logs, Eval, Session, Prompts, MCP Debug).

"Minimal access by default, add as needed"

Enable only Agents by default. Add other sections per user as they request them.

"Developer-focused defaults"

Enable Agents, Traces, Logs, Eval, and MCP Debug by default. Leave Prompts and Session disabled.


Tips for Beginners

  • Set defaults before bulk inviting — If you're about to invite many users, configure the Permission Matrix first. It saves you from configuring each user individually.
  • Defaults don't retroactively change — Changing a default only affects future invites. Existing users keep their current settings.
  • Admin-only sections are read-only — You can see them in the matrix for reference, but they can't be toggled for Tenant Users.