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.

Personal API Keys

Users can create API keys for programmatic access on their workspaces. They stay associated to them.
# Using a personal API key
curl -X GET https://api.noxus.ai/v1/workflows \
  -H "Authorization: Bearer sk_user_abc123..."
Personal API keys inherit the user’s permissions across all workspaces they have access to. For service accounts or limited-scope access, use workspace-level API keys.

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


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