Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
As your organization evolves, you might need to rename or remove a team to better align with new roles, projects, or organizational structures.
When you rename a team, the new name automatically propagates throughout Azure DevOps, ensuring consistency and avoiding confusion. The following team artifacts automatically get renamed:
Team security group
Team backlogs and boards
Team dashboards
Automatic renaming maintains access controls, project tracking, and dashboard configurations without manual updates. Removing a team deletes its configurations and reassigns its members to other teams, ensuring workflow continuity and organizational clarity.
Tip
Update any queries that reference the old team security group name.
Deleting a team removes all configuration settings, including dashboards, backlogs, and boards. Work item data remains unchanged. Team configurations cannot be recovered after deletion.
Prerequisites
Permissions:
To rename a team, be a team administrator or a member of the Project Administrators group.
az devops team update --team
[--description]
[--name]
[--org]
[--project]
Parameters
team: Optional. Name or ID of a team.
description: Optional. Description to apply to the team.
name: Optional. Name to apply to rename the team.
org: Optional. URL of organization. You can configure the default organization using az devops configure -d org=URL. Required if not configured as default or picked up via git config.
project: Optional. Name or ID of the project. Example: --project "Fabrikam Fiber." You can configure the default project using az devops configure -d project=NAME_OR_ID. Required if not configured as default or picked up via git config.
Example
For example, the following command renames the Account Management team to Organization Management. For addition output formats, see Output formats for Azure CLI commands.
Azure DevOps CLI commands aren't supported for Azure DevOps Server.
Set a team as the default
When a project gets created, a default team also gets created based on the project name.
Open Project settings > Teams.
Select More options next to the team you want as the new default, and then select Set team as project default.
Delete a team
You can delete any team except the default team. At least one team must be defined for a project.
Important
Deleting a team removes all team configuration settings (dashboards, backlogs, boards). Work item data remains unchanged. Team configurations cannot be recovered once deleted.
From your project in the web portal, select Project settings > Teams as shown in the previous section.
Select the team you want to delete and then select Settings.
Scroll down and select Delete Team.
Select Delete in the confirmation box to complete the delete operation.
The New Teams user interface isn't supported for Azure DevOps Server 2020 and earlier versions.
From your project in the web portal, select Project settings > Teams > … for the team you want to delete, and then select Delete.
Important
Deleting a team deletes all team configuration settings, including team dashboards, backlogs, and boards. Data defined for work items assigned to the team are left unchanged. Once deleted, you can't recover the team configurations.
To complete the delete operation, you must enter the name of the work item type as shown in the following example.
More options next to the team you want as the new default, and then select Set team as project default.
