Project collaborators

Collaborators are the people you add to the project to work together. After you create a project, add collaborators to share knowledge and resources freely, shift workloads flexibly, and help one another complete jobs.

Required permissions
To manage collaborators, you must have the Admin role in the project.

Add collaborators

You can invite only users who are added to the project creator's IBM Cloud account.

Watch this video to see how to add collaborators and grant them access to your projects. The video begins on the watsonx home screen, in the Projects section. The user opens the Transportation Data Analysis project to explore collaboration features.

This video provides a visual method to learn the concepts and tasks in this documentation.

Tip: Add at least one other user as a project administrator to ensure that someone is able to manage the project if you are unavailable.

Add service IDs

You can create service IDs in IBM Cloud to enable an application outside of IBM Cloud access to your IBM Cloud services. Because service IDs are not tied to a specific user, if a user happens to leave an organization and is deleted from the account, the service ID remains ensuring that your application or service stays up and running. See Creating and working with service IDs.

Add user groups

You can add user groups as collaborators if your IBM Cloud account contains IAM access groups. An IBM Cloud account administrator can create IAM access groups, which are then available as user groups in projects. If a user is added to a workspace more than once, they have a higher role. For example, if a user is added as an individual with Editor role and as part of a user group with Admin role, that user has the Admin role. For more information, see Setting up IAM access groups.

Adding collaborators

To add collaborators to your project:

  1. From your project, click the Access Control page on the Manage tab.

  2. Click Add collaborators then select Add users, Add service IDs or Add user groups.

    • Users:
      • Type email addresses into the Find users field.
      • Copy multiple email addresses, separated by commas, and paste them into the Find users field.
    • Service IDs:
      • In the Find service IDs field, search for the service name or description and select the one you want.
    • User groups:
      • In the Find groups field, search for user groups and select the one you want.

  3. Choose the role for the collaborators and click Add:

    • Viewer: View the project.
    • Editor: Control project assets.
    • Admin: Control project assets, collaborators, and settings.

  4. Add other users, service IDs, or user groups that you want to have the same access level.

  5. Select the access level.

  6. Click Add.

The invited users are added to your project immediately.

Change collaborator roles

You can change the role for a collaborator on the Access Control page on the Manage tab.

Remove a collaborator

You can remove a collaborator or service ID from a project on the Access Control page on the Manage tab.

Important: If you're using watsonx.governance, review the service IDs before you delete them. A service ID with Viewer access is added when you associate a use case to a project or space. Do not delete the ServiceId collaborator. The service ID is required by the system.