Skip to main content
Noxus uses a fine-grained permission system based on scopes. These permissions directly control the user experience by modifying what features and data are visible within the platform interface. Beyond the UI, these permissions also apply to API Keys. When creating or managing API keys, the available scopes are restricted by the user’s own permissions—you can only grant an API key the permissions that you yourself possess. Permissions are divided into Workspace-level scopes and Global/Organization-level scopes.

Workspace-Level Scopes

These scopes are specific to individual workspaces and control user permissions within a particular workspace.
CategoryScope NameLabelDescription
Flowsworkspace.flows.createCreateCreate workflows/flows
workspace.flows.editEditEdit workflows/flows
workspace.flows.deleteDeleteDelete workflows/flows
workspace.flows.runRunExecute workflows/flows
workspace.flows.advancedAdvancedAdvanced workflow operations
Agentsworkspace.agents.createCreateCreate agents
workspace.agents.editEditEdit agents
workspace.agents.deleteDeleteDelete agents
workspace.agents.runRunExecute agents
workspace.agents.advancedAdvancedAdvanced agent operations
Knowledge Basesworkspace.kbs.createCreateCreate knowledge bases
workspace.kbs.editEditEdit knowledge bases
workspace.kbs.deleteDeleteDelete knowledge bases
workspace.kbs.runRunQuery knowledge bases
workspace.kbs.advancedAdvancedAdvanced KB operations
Administrationworkspace.integrations.editEdit IntegrationsManage workspace integrations
workspace.users.editEdit UsersManage workspace users
workspace.users.deleteDelete UsersRemove users from workspace
workspace.settings.editEdit SettingsModify workspace settings

Global/Organization-Level Scopes

These scopes apply across the entire organization and control user permissions at the organization level.
CategoryScope NameLabelDescription
Usersusers.readReadView user information
users.writeWriteCreate users
users.editEditModify user information
users.deleteDeleteRemove users
Workspacesworkspace.readReadView workspace information
workspace.writeWriteCreate workspaces
workspace.editEditModify workspaces
workspace.deleteDeleteRemove workspaces
Organizationorg.readReadView organization information
org.editEditModify organization settings
org.billingBillingManage billing and subscriptions
Global Settingssettings.readReadView global settings
settings.editEditModify global settings
settings.adminAdminFull administrative access