# Source: https://docs.zenml.io/api-reference/pro-api/pro-api/organizations/teams.md

# Source: https://docs.zenml.io/api-reference/pro-api/pro-api/teams.md

# Source: https://docs.zenml.io/pro/core-concepts/teams.md

# Teams

ZenML Pro introduces the concept of Teams to help you manage groups of users efficiently. A team is a collection of users that acts as a single entity within your organization and workspaces. This guide will help you understand how teams work, how to create and manage them, and how to use them effectively in your MLOps workflows.

## Understanding Teams

Teams in ZenML Pro offer several key benefits:

1. **Group Management**: Easily manage permissions for multiple users at once.
2. **Organizational Structure**: Reflect your company's structure or project teams in ZenML.
3. **Simplified Access Control**: Assign roles to entire teams rather than individual users.

## Creating and Managing Teams

Teams are created at the organization level and can be assigned roles within workspaces, similar to individual users.

To create a team:

{% stepper %}
{% step %}
**Go to the Organization Settings**

Click on the **Settings** tab from your **Organization** page.

<figure><img src="https://884225131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoT4CiM88wQeSLTcwLU2J%2Fuploads%2Fgit-blob-b11fa0ccb1456f290405b313c38a711572266d5d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Click on the Teams tab**

Go to the **Members** section from the sidebar and select the **Teams** tab.

![Create Team](https://884225131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoT4CiM88wQeSLTcwLU2J%2Fuploads%2Fgit-blob-687edb2bf59b9fe6fe20d0bdc885a89d960b8266%2Fcreate_team.png?alt=media)
{% endstep %}

{% step %}
**Add a New Team**

Use the **Add team** button to add a new team.

<figure><img src="https://884225131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoT4CiM88wQeSLTcwLU2J%2Fuploads%2Fgit-blob-3ae666052fdeac913fa846320a4e826a5df22993%2Fimage.png?alt=media" alt="" width="271"><figcaption></figcaption></figure>

When creating a team, you'll need to provide:

* Team name
* Description (optional)
* Initial team members
  {% endstep %}
  {% endstepper %}

## Adding Users to Teams

To add users to an existing team:

{% stepper %}
{% step %}
Go to the **Teams** tab in **Organization** settings
{% endstep %}

{% step %}
Select the team you want to modify
{% endstep %}

{% step %}
Click on **Add Members**
{% endstep %}

{% step %}
Choose users from your organization to add to the team

![Add Team Members](https://884225131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoT4CiM88wQeSLTcwLU2J%2Fuploads%2Fgit-blob-ce051cd6650ce7eaf8bd8a715b5e8945ba75f250%2Fadd_team_members.png?alt=media)
{% endstep %}
{% endstepper %}

## Assigning Teams to Workspaces

Teams can be assigned to workspaces just like individual users. To add a team to a workspace:

{% stepper %}
{% step %}
Go to the **Workspace Settings** page
{% endstep %}

{% step %}
Click on **Members** tab and click on the **Teams** tab.
{% endstep %}

{% step %}
Select **Add Team**
{% endstep %}

{% step %}
Choose the team and assign a role

![Assign Team to Workspace](https://884225131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoT4CiM88wQeSLTcwLU2J%2Fuploads%2Fgit-blob-2bd6d1ab990acab6c9a08569038c0ba18e0306a4%2Fassign_team_to_tenant.png?alt=media)
{% endstep %}
{% endstepper %}

## Team Roles and Permissions

When you assign a role to a team within a workspace, all members of that team inherit the permissions associated with that role. This can be a predefined role (Admin, Editor, Viewer) or a custom role you've created.

For example, if you assign the "Editor" role to a team in a specific workspace, all members of that team will have Editor permissions in that workspace.

![Team Roles](https://884225131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoT4CiM88wQeSLTcwLU2J%2Fuploads%2Fgit-blob-99d236fd9980ae96a4e5bb72b3b5d0a80a6be5ee%2Fteam_roles.png?alt=media)

## Best Practices for Using Teams

1. **Reflect Your Organization**: Create teams that mirror your company's structure or project groups.
2. **Combine with Custom Roles**: Use custom roles with teams for fine-grained access control.
3. **Regular Audits**: Periodically review team memberships and their assigned roles.
4. **Document Team Purposes**: Maintain clear documentation about each team's purpose and associated projects or workspaces.

By leveraging Teams in ZenML Pro, you can streamline user management, simplify access control, and better organize your MLOps workflows across your organization and workspaces.

<figure><img src="https://static.scarf.sh/a.png?x-pxid=f0b4f458-0a54-4fcd-aa95-d5ee424815bc" alt="ZenML Scarf"><figcaption></figcaption></figure>