Skip to content

delete-existing-repo.md

Latest commit

 

History

History
107 lines (76 loc) · 5.21 KB

delete-existing-repo.md

File metadata and controls

107 lines (76 loc) · 5.21 KB
title Delete a Git Repo from Your Project
titleSuffix Azure Repos
description Learn how to delete a Git repository from your Azure DevOps project. Follow these steps to remove unused repos and keep your project organized.
ms.assetid 271f8473-e77d-4a95-80d9-0bd347de7533
ms.custom support-driven-update
ai-usage ai-assisted
ms.service azure-devops-repos
ms.topic how-to
ms.date 03/04/2026
monikerRange <= azure-devops
ms.subservice azure-devops-repos-git

Delete a Git repo from your project

[!INCLUDE version-lt-eq-azure-devops]

Remove unused Git repos from your project when they're no longer needed. The steps in this article show how to delete a Git repo from your Azure DevOps project. If you want to delete the entire project, see Delete a project.

Important

  • Deleted Git repositories are soft-deleted and remain in a recycle bin for 30 days. During this period, you can restore a deleted repository by using the Restore Repository From Recycle Bin REST API. After 30 days, repositories are permanently deleted and can't be recovered.
  • You can't remove a repo if it's the only Git repo in the Azure DevOps project. If you need to delete the only Git repo in a project, create a new Git repo first, and then delete the repo.

Prerequisites

Category Requirements
Permissions Delete Repository permission

::: moniker range="azure-devops"

Note

To use the Azure DevOps CLI az repos delete command, see Get started with Azure DevOps CLI. ::: moniker-end

Delete a Git repo from the web

Tip

Instead of deleting a repo, consider renaming it with an _archived prefix and locking its default branch. This approach retires the repo from active use while preserving commit history, pull request records, and existing links.

Browser

  1. Sign in to your project (https://dev.azure.com/{Your-Organization}/{Your-Project}).

  2. Select Project settings.

  3. Select Repositories and the name of the repository from the Repositories list. Select the ellipsis (...) for more actions, and then select Delete.

    Screenshot that shows the Delete repository action.

  4. To confirm the deletion of the repository, enter the name of the repo and select Delete.

    Screenshot that shows the Delete repository confirmation dialog.

    The repository is removed from the Repositories list. It remains in the recycle bin for 30 days before permanent deletion.

Azure DevOps CLI

::: moniker range="azure-devops"

You can use Azure DevOps CLI to delete an Azure DevOps Git repository.

az repos delete --id
                     [--detect {false, true}]
                     [--org]
                     [--project]
                     [--subscription]
                     [--yes]

Parameters

Parameter Description
id ID of the repository. You can get the repository ID by running az repos list.
detect Automatically detect organization. Accepted values are false and true.
org, organization Azure DevOps organization URL. You can configure the default organization by using az devops configure -d organization=<ORG_URL>. Required if not configured as default or picked up via git config. An example is https://dev.azure.com/MyOrganizationName/.
project, p Name or ID of the project. You can configure the default project by using az devops configure -d project=<NAME_OR_ID>. Required if not configured as default or picked up via git config.
subscription Name or ID of the subscription. You can configure the default subscription by using az account set -s <NAME_OR_ID>.
yes Don't prompt for confirmation.

Example

The following command deletes the Fabrikam repository, ID 0d58f562-4a10-495d-94d7-7ac61a22d7cc. This example uses the following default configuration: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos delete --id  0d58f562-4a10-495d-94d7-7ac61a22d7cc
Are you sure you want to delete this repository? (y/n): y

::: moniker-end

::: moniker range="< azure-devops" [!INCLUDE temp] ::: moniker-end

Related content