Skip to main content

Organization Role-Based Access Control (RBAC)

Control who can do what within your Monad organization using roles and permissions.

Overview

Every Monad organization uses role-based access control to manage user permissions. Key concepts:

  • Roles are scoped to organizations — each user has exactly one role per organization.
  • Roles contain granular permissions that control what a user can view, create, modify, or delete.
  • Three default roles ship with every new organization. You can also create custom roles with any subset of permissions.

Default Roles

Every new organization is created with three protected roles that cannot be edited or deleted:

  • Admin — Full access to all resources and settings, including user management, role management, organization settings, and SSO configuration.
  • Contributor — Read/write access to pipelines, inputs, outputs, transforms, enrichments, secrets, API keys, and alert rules. Can view organization logs and metrics. Cannot manage users, roles, organization settings, or SSO connections.
  • Reader — Read-only access across pipelines, inputs, outputs, transforms, enrichments, secrets, API keys, organization logs, and alert rules. Cannot create, modify, or delete any resources.

Permissions Matrix

The table below shows which permissions are included in each default role.

ResourcePermissionAdminContributorReader
Pipelinespipeline:read
pipeline:write
pipeline:delete
pipeline:data:read
pipeline:data:write
pipeline:logs:read
pipeline:metrics:read
Inputsinput:read
input:write
input:delete
Outputsoutput:read
output:write
output:delete
Transformstransform:read
transform:write
transform:delete
Enrichmentsenrichment:read
enrichment:write
enrichment:delete
Secretssecrets:read
secrets:write
secrets:delete
API Keysapikey:read
apikey:write
apikey:delete
Alert Rulesalert_rule:read
alert_rule:write
alert_rule:delete
Usersuser:read
user:write
user:delete
Rolesrole:read
role:write
role:delete
Organizationorganization:write
organization:delete
organization:logs:read
SSO Connectionssso_connection:read
sso_connection:write
sso_connection:delete

Permissions Reference

All 37 organization permissions grouped by resource.

Pipelines

PermissionDescription
pipeline:readView and list all pipelines within the organization
pipeline:writeCreate new pipelines and update existing pipeline configurations
pipeline:deleteDelete existing pipelines from the organization
pipeline:data:readView live data as it moves through the pipeline
pipeline:data:writePublish pipeline data to HTTP or TCP inputs
pipeline:logs:readAccess and view execution logs for all pipelines
pipeline:metrics:readAccess and view performance metrics and statistics for pipelines

Inputs

PermissionDescription
input:readView and list all input configurations within the organization
input:writeCreate and modify input configurations for pipelines
input:deleteDelete input configurations from the organization

Outputs

PermissionDescription
output:readView and list all output configurations within the organization
output:writeCreate and modify output configurations for pipelines
output:deleteDelete output configurations from the organization

Transforms

PermissionDescription
transform:readView and list all transform configurations within the organization
transform:writeCreate and modify transform configurations for pipelines
transform:deleteDelete transform configurations from the organization

Enrichments

PermissionDescription
enrichment:readView and list all enrichment configurations within the organization
enrichment:writeCreate and modify enrichment configurations
enrichment:deleteDelete enrichment configurations

Secrets

PermissionDescription
secrets:readList and view secret metadata without exposing actual secret values
secrets:writeCreate, update, and manage secret values used in pipelines
secrets:deleteDelete secrets from the organization

API Keys

PermissionDescription
apikey:readView and list all API keys within the organization
apikey:writeCreate, regenerate, and manage API keys for system access
apikey:deleteDelete API keys from the organization

Alert Rules

PermissionDescription
alert_rule:readView and list all alert rules within the organization
alert_rule:writeCreate and modify alert rules
alert_rule:deleteDelete alert rules from the organization

Users

PermissionDescription
user:readView and list all users within the organization
user:writeInvite new users to the organization and manage existing user accounts
user:deleteRemove users from the organization

Roles

PermissionDescription
role:readView and list all roles and their associated permissions
role:writeCreate, modify, and assign roles to users
role:deleteDelete roles from the organization

Organization

PermissionDescription
organization:writeUpdate organization information such as name and description
organization:deleteDelete the entire organization
organization:logs:readView organization-wide logs including API request logs

SSO Connections

PermissionDescription
sso_connection:readView and list all SSO connections within the organization
sso_connection:writeCreate and modify SSO connections
sso_connection:deleteDelete SSO connections

Managing Roles

Navigate to your organization and select the Roles tab to manage roles.

Viewing Roles

The Roles tab displays a searchable table of all roles in your organization. Each row shows the role name, description, and available actions.

Creating a Custom Role

  1. Click Create role.
  2. Enter a name and description for the role.
  3. Select permissions from the grouped checklist. You can select or deselect all permissions within a category at once.
  4. Click Create to save the role.

Note: You can only assign permissions that your own role has. This prevents privilege escalation — you cannot create a role with more access than you currently have.

Editing a Custom Role

  1. Click the edit action on the role row.
  2. Modify the name, description, or permissions as needed.
  3. Click Save to apply changes.

Protected roles (Admin, Contributor, Reader) cannot be edited.

Deleting a Custom Role

  1. Click the delete action on the role row.
  2. Confirm the deletion.

Only custom roles with no assigned users can be deleted. Protected roles (Admin, Contributor, Reader) cannot be deleted.

Managing Users

Navigate to your organization and select the Users tab to manage users.

Viewing Users

The Users tab shows all organization members with their email address, assigned role, and authentication provider.

Inviting a User

  1. In the invite form, enter the user's email address.
  2. Select a role from the dropdown.
  3. Click Invite to send the invitation.

Changing a User's Role

  1. Click the edit action on the user row.
  2. Select a new role from the dropdown.
  3. Confirm the change.

Removing a User

  1. Click the remove action on the user row.
  2. Confirm the removal.

Note: You cannot remove yourself from the organization.

API Key Roles

API keys also have role assignments within your organization. When you create or manage an API key, you assign it a role just like you would a user. The permissions for that API key are determined by its assigned role — the same permission system applies.

Manage API key roles under the API Keys tab in your organization settings.