Teams

Teams are groups of users within an organization (org) that can be assigned common permissions. You can define a team for a specific component or access level. For example, you can create a team of users and assign them to a role granting them admin permissions for a specific component, but maintaining read-only access to everything else. This setup ensures that this team has the necessary control over their designated area, but withholds broader administrative access.

System-generated teams

System-generated teams are designed to simplify adding new users and admins to an org by automatically providing a set of permissions based on team membership. This approach eliminates the need to configure permissions for each individual, allowing you to quickly invite users, assign them appropriate permissions, and enable them to use the platform with approved access. For added flexibility, you can also create custom teams tailored to specific project needs.

Table 1. System-generated team permissions
Team	Permissions
User (System)	Read-only access to all functionality within the tenant org.
Admin (System)	Full administrative control over all functionality within the tenant org, including access control management, resource creation and configuration, and user invitations.

A user may have User (System) permissions granted for one or more orgs, and Admin (System) permissions granted for others.

For example, User-A is a member of the following system-generated teams:

The Admin (System) team in the tenant Organization-A they were automatically assigned to when they signed up for the CloudBees platform.
The Admin (System) team in Organization-B granted to them when they accepted an invitation to that org.
The User (System) team in Organization-C granted to them when they accepted an invitation to that org.

User-A can also be a member of multiple custom teams. Each team is only valid for the granting org. View each org you are a member of in User profile Organizations, that also displays the specific role granted.

Access teams and team details

Manage and view all teams available within a tenant.

To access teams, and team details:

Select Admin settings on the top next to your username.
Select Teams.
(Optional) Search for a specific team by entering all or part of a team name into Search.

(Optional) Sort the team list using one of these methods:

Select an option in Sort by: Choose Ascending or Descending alphanumerical sort order.

Select next to a heading to sort on that heading.

Once sorted, either (for descending), or (for ascending), is displayed to the right of the column heading.
To switch an existing sort order, select , or , as applicable (or select an option in Sort by).
The default sort is ascending by Name.

(Optional) Search for a specific team, by entering all or part of a team name into Search.
1. Select from the Type options.
2. Select to close the filter.
(Optional) Display details of a specific team:
1. Select next to the team you want to display.
2. Select View team details.

You are displaying your teams, listed according to any sorting, filtering, or searching you have done. Team details are optionally displayed.

Create a team

Create any number of teams to organize CloudBees platform users.

To create a team:

Select Admin Settings on the top next to your username.
Select Teams.
Select Create team.
Enter a Display name.
(Optional) Enter a Description.
Select an existing platform user from the options in Add user to add them to the team.
(Optional) Select Add another user for each additional user to add them to the team.

Select Owner next to an added user to make them an owner of the team.

A team may have multiple owners.
The owner permission allows non-admin users to manage team membership independently, including adding or removing users.
Tenant admins have full editing rights for all teams.

Select Create.

Your team is created, and listed in Teams.

Remove a team

Removing a team removes all team privileges, and all access to the team. This action is irreversible.

To remove a team:

Select Admin Settings on the top next to your username.
Select Teams.
Select next to the team you want to remove.
Select Remove team.
Select Remove team.

The team is removed, and no user can access the team. This action cannot be undone.