Skip to main content
Managing team members at the project level allows you to control who has access to specific projects and what they can do within them.

Prerequisites

Before you can add team members to a project, users must first be part of your organization. If you haven’t invited users yet, please refer to the Team Member Management guide to learn how to invite users to your organization.
Important: Users must accept their organization invitation before they can be assigned to any projects.

Adding Team Members to a Project

Once users are part of your organization, you can assign them to specific projects: Add Members to Project Modal
  1. Navigate to your Project within the dashboard.
  2. Go to the Team Members or Settings section of the project.
  3. Click on the Add Members button.
  4. In the Add Members to Agent modal that appears:
    • Use the search bar to find users by name or email
    • Select the users you want to add to the project
    • Assign appropriate roles for each user
  5. Click Add Selected Users to confirm.
You can select multiple users at once to add them to your project in a single action.

User Workflow Overview

Here’s the complete workflow for adding a user to a project:

Step-by-Step Process

  1. Organization Invitation
    • An organization admin invites the user via email
    • The invitation is sent from the Organization Team Members page
  2. User Acceptance
    • The user receives an email invitation
    • They click the invitation link and accept
    • Their account is now part of the organization
  3. Project Assignment
    • Organization members can now be assigned to projects
    • Project admins can add these users to specific projects
    • Users are searchable by name or email within the project

Managing Project Team Members

After adding team members to your project, you can:
  • View Project Members: See all users assigned to the current project
  • Update Roles: Modify permissions for project-specific access
  • Remove Members: Remove users from the project (they remain in the organization)

Project-Level Roles

Project roles determine what actions users can perform within a specific project:
RolePermissions
Project AdminFull control over the project, including settings, team management, and deletion.
EditorCan modify project configurations, knowledge base, workflows, and agents.
ViewerRead-only access to project data and analytics.
Project-level roles are independent of organization-level roles. A user with “Viewer” role at the organization level can be assigned “Project Admin” role for a specific project.

Best Practices

Follow the principle of least privilege by granting users only the permissions they need for their specific tasks.
Periodically review project team members and remove access for users who no longer need it.
When managing multiple projects, use clear naming conventions to help team members identify which projects they should access.
When adding new team members to a project, provide them with context about the project’s purpose and their responsibilities.

Troubleshooting

If you can’t find a user when trying to add them to a project:
  • Verify Organization Membership: Ensure the user has accepted their organization invitation
  • Check Email Address: Make sure you’re searching with the correct email address
  • Wait for Sync: If the user just joined, wait a few moments and refresh the page

User Can’t Access Project

If a user reports they can’t access a project:
  1. Confirm they are added to the project team
  2. Verify their project role has appropriate permissions
  3. Check that their organization membership is still active
  4. Ensure they are logged in with the correct account
Removing a user from the organization will automatically remove them from all projects within that organization.