Skip to main content
Users in Noxus represent individual team members who have access to your workspaces. Each user has their own credentials, role, and activity tracking across one or more workspaces.

​
User Profile

Each user has a personal profile that applies across all workspaces. It carries the following information:
  • Name and display name
  • Email address (login credential)
  • Profile picture/avatar

​
User Roles

Noxus provides a role-based access control (RBAC) system with clearly defined permissions. There are two role types:
  • Organization role - Defines the permissions at the organization (platform) level.
  • Workspace role - Defines the permissions at the workspace level. One per workspace.
When a user is an admin in the organization, they will also be an admin on all workspaces. To learn more, see Permissions & roles.

​
API Keys

API keys provide programmatic access to a specific workspace. Each key is scoped to one workspace and can optionally be restricted to a subset of that workspace’s permissions. 
# Using an API key
curl -X GET https://api.noxus.ai/v1/workflows \
  -H "Authorization: Bearer noxus_abc123..."
Keys are created from Workspace Control → API keys. When creating a key you can toggle Restrict permissions to limit the key to only specific workspace permissions.
A key can never have more permissions than the user who created it. If a user’s permissions are reduced, any keys they created retain only the permissions that still overlap.

​
User Management

​
Adding New Users

Add new members to your organization:
1

Navigate to Settings

Go to Settings → Users
2

Add User

Click “Add user” and:
  • Enter their name, email address, and organization role
  • Select which workspaces to add the user to
3

Assign Workspace Roles

Click “Next” and select the role for each workspace (platform admins are admins on all workspaces)
4

Invite User

Click “Add”. The invited user will receive an email with the invitation

​
Adding Existing Users to a Workspace

Invite team members to a workspace:
1

Navigate to Workspace Users

Go to Workspace settings → Users
2

Send Invitation

Click “Add users” and select which users to add
3

Assign Role

Select the appropriate role for each user
4

Add user

Click “Add”. The user will be added to that workspace
You can also use the API and SDK to add users to the platform.

​
User Onboarding and Offboarding

When a user first joins a workspace:
  1. Email invitation - Receives an invite with workspace details.
  2. Account creation - Creates an account or signs in to an existing one.
  3. Workspace tour - Optional guided tour of key features.
  4. Role assignment - Receives an assigned role and permissions.
  5. Resource access - Can immediately access resources based on their role.

​
Training & Resources

Documentation

Comprehensive platform documentation.

Video Tutorials

Step-by-step video guides (coming soon).

Example flows

Templates and examples to learn from inside the platform.

Support

Reach out to our support team.

​
Best Practices

  • Follow Least Privilege: Grant the minimum permissions required for each user’s role.
  • Regular Access Reviews: Quarterly review of user permissions and adjust as needed.
  • Separate Roles by Function: Don’t make everyone an Admin; use appropriate roles.
  • Use Service Accounts: For integrations, avoid using personal accounts.

​
Other Core Concepts

Workspaces

Isolated environments for your projects and resources

Flows

Start building flows in your workspace

Agents

Create and develop AI agents for your team

Knowledge Bases

Intelligent data repositories to enhance your tools