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, both of the following conditions must be true:
-
- You must have the Admin role in the project.
-
- You must belong to the project creator's IBM Cloud account.
Add collaborators
The eligibility of collaborators is affected by whether the project is restricted by the Restrict who can be a collaborator setting:
- If the project is restricted, you can add members of your IBM Cloud account as collaborators, or, if your company has SAML federation on IBM Cloud, you can add any user who has a company email address. To add users to your IBM Cloud account, see Set up additional account users.
- If the project is not restricted, you can add anyone you want as a collaborator.
You can see whether the project is restricted and whether SAML federation is enabled on the project General page on the Manage tab.
Watch this video to see how to add collaborators and grant them access to your projects.
This video provides a visual method to learn the concepts and tasks in this documentation.
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.
To add collaborators to your project:
-
From your project, click the Access Control page on the Manage tab.
-
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.
- Users:
-
Choose the role for the collaborators and click Add:
- Viewer: View the project.
- Editor: Control project assets.
- Admin: Control project assets, collaborators, and settings.
-
Add other users, service IDs, or user groups that you want to have the same access level
-
Select the access level.
-
Click Add.
If the invited users have existing IBM Cloud accounts with watsonx.ai Studio activated, they are added to your project immediately.
If an invited user does not have a IBM Cloud account, the user receives an email invitation to create a IBM Cloud account and activate watsonx.ai Studio. When the user activates watsonx.ai Studio, the user can see your project and the user's status on your collaborators list changes from Invited to Active. If necessary, you can resend or cancel an invitation.
Change collaborator roles
To change the role for a project collaborator or service ID:
- Go to the Access Control page on the Manage tab.
- In the row for the collaborator or service ID, click the edit icon next to the role name.
- Select the new role and click Save.
Remove a collaborator
To remove a collaborator or service ID from a project, go to the Access Control page on the Manage tab. In the row for the collaborator or service ID, click the remove icon.
Learn more
Parent topic: Administering projects