Skip to main content

Team management

This guide explains how to manage team members in your Kapa account, including adding new users, assigning roles, and removing users.

Managing your team​

Use the team page on the Kapa platform to manage all users in your Kapa team. To access the team page:

  1. Open the Kapa platform
  2. Click your account name at the bottom of the sidebar to open the account menu.
  3. Select Team Members under Settings.

Team Members option in the account menu

Only users with the Owner role can manage team members.

Add a new user​

  1. Go to the team page on the Kapa platform
  2. Click the Invite button to open the new user dialog
  3. Enter the email address of the user you want to add
  4. Click Send invite to invite the user

The system sends an email invitation to the specified address. The user must accept the invite by following the link in the email to join your Kapa team.

note

If SCIM provisioning is enabled for your team, email invitations are disabled. Users must be provisioned through your identity provider.

note

New users are created without access to your projects. You must manually assign the relevant project permissions. For more information about projects, see Projects.

Automatic user provisioning​

It's possible to configure your authentication mechanism to enable automatic user provisioning for your Kapa team. When enabled, Kapa accounts are automatically provisioned for users who sign in using email addresses associated with your team domain.

Automatically provisioned users are granted access to the Internal Technical Assistant only.

If you need to add a verified team domain, reach out to the Kapa team.

OAuth​

To manage automatic user self-signup and provisioning for OAuth:

  1. Open the Kapa platform
  2. Click your account name at the bottom of the sidebar to open the account menu.
  3. Select Authentication under Settings.
  4. Enable self-signup in the OAuth section.

Only users with the Owner role can manage authentication settings.

SAML (SSO)​

Automatic user self-signup and provisioning is automatically enabled for teams who have configured SAML.

SCIM​

For organizations that require centralized user lifecycle management, SCIM provisioning enables automatic user creation and deactivation through your identity provider. See SCIM provisioning for details.

Change user roles​

To change a user's role within the team:

  1. Go to the team page on the Kapa platform
  2. Locate the user in the list
  3. Click the Manage Access button.
  4. Use the role dropdown to select either Owner or Member

Note that changing roles affects global team permissions but not project-specific permissions. See role-based permissions for more details.

Delete a user​

To remove a user from your team:

  1. Go to the team page on the Kapa platform
  2. Locate the user in the list
  3. Click the Delete button
  4. Confirm the deletion when prompted

When you delete a user, they immediately lose access to all projects in your team.

note

If SCIM provisioning is enabled for your team, users must be deprovisioned through your identity provider and cannot be deleted manually.