Azure DevOps Services · Azure CLI · October 27, 2026

az repos pr: Azure DevOps pull requests from the command line

The Azure DevOps extension for the Azure CLI adds az repos pr, which creates, lists, votes on and completes pull requests in Azure Repos. It works only with Azure DevOps Services: Microsoft says the extension does not support Azure DevOps Server. From Microsoft's az repos pr reference, Get started with Azure DevOps CLI and Sign in with a personal access token.

Set it up

• Install: install the Azure CLI, then az extension add --name azure-devops (az extension update --name azure-devops to update it).
• Sign in: az login (Microsoft Entra, which Microsoft recommends over personal access tokens); or az devops login --organization https://dev.azure.com/contoso and paste a personal access token at the prompt (also piped from stdin, in a non-interactive shell); or set AZURE_DEVOPS_EXT_PAT, which the commands use when you have not signed in either way. Guest users can only use az devops login.
• Defaults: az devops configure --defaults organization=https://dev.azure.com/contoso project=ContosoWebApp. Without defaults, give --org and --project, or run the command in a clone so they are picked up from git config (--detect). --repository names the repository.

Create a pull request

az repos pr create --source-branch feature/login --target-branch main --title "Add login" --description "First line" "Second line"

• Without --target-branch, the repository's default branch. Each value given to --description becomes a line; Markdown works.
• --reviewers (or --optional-reviewers) and --required-reviewers add people or groups, separated by spaces; --work-items links work items by ID; --labels adds labels (tags).
• --draft true creates a draft; --auto-complete true sets auto-complete at once, with --squash, --delete-source-branch, --merge-commit-message and --transition-work-items for when it completes; --open opens it in the browser.

Find and read pull requests

• az repos pr list lists pull requests; --status takes active, completed, abandoned or all. --creator, --reviewer, --source-branch and --target-branch filter; --top and --skip page. For example az repos pr list --reviewer me@contoso.com --output table.
• az repos pr show --id 21 gives the details; az repos pr checkout --id 21 checks out the source branch, if you have no local changes (--remote-name, origin by default).
• az repos pr reviewer list|add|remove --id 21 and az repos pr work-item list|add|remove --id 21 manage reviewers and linked work items.
• az repos pr policy list --id 21 lists the branch policies with their state, and az repos pr policy queue --id 21 --evaluation-id … runs one again, such as an expired build.

Vote and complete

• az repos pr set-vote --id 21 --vote approve; the values are approve, approve-with-suggestions, wait-for-author, reject and reset (what each vote means).
• az repos pr update --id 21 --status completed completes it, with --squash, --delete-source-branch, --merge-commit-message and --transition-work-items; --status abandoned abandons it and --status active sets it active again.
• az repos pr update --id 21 --auto-complete true sets auto-complete; set this way it can wait on optional policies too (auto-complete and optional policies). --draft false publishes a draft, and --title and --description change the text.
• --bypass-policy true --bypass-policy-reason "…" completes past required policies, for people allowed to override them.

Pull requests in IntelliJ IDEA

Azure DevOps Pull Requests, a plugin by Lesstep for JetBrains IDEs 2024.1 or later and Android Studio, lists the pull requests waiting for your vote in an IDE tool window, with their diffs, comments and branch policies, on Azure DevOps Services and on Azure DevOps Server, where the Azure CLI does not go. On Azure DevOps Services it can use your Azure CLI sign-in: with Use my Azure CLI sign-in (az login) instead of a token, it asks the Azure CLI for a short-lived Entra token and keeps it in memory only. Reading is free; voting, commenting, completing and creating pull requests are Pro, with a 30-day trial.

Get it on JetBrains Marketplace

Azure DevOps and Azure are trademarks of Microsoft Corporation; IntelliJ IDEA is a trademark of JetBrains s.r.o. This page is not affiliated with or endorsed by Microsoft or JetBrains.

More: auto-complete and optional policies · build validation and expired builds · global personal access tokens are retired · TF401179: an active pull request already exists · 日本語