Skip to main content
Review the minimum standard delegated scope mapping for every Azure DevOps action. These scopes are Azure DevOps REST scopes (vso.*) on the Azure DevOps resource, not Microsoft Graph. Wiki and work-item search actions that first list or resolve projects also require vso.project. Sites.Selected does not apply.

Minimal scopes per action

Each Azure DevOps connection also requests openid, offline_access, and vso.profile. These connection scopes apply in addition to the action scopes in the table.
ActionDescriptionMinimum scopes
Add work item commentAdds a comment to a work item.vso.work_write
Check wiki page accessChecks whether the connected account can still read a wiki page.vso.wiki
Commit filesPushes an atomic commit with file creates, edits, or deletes.vso.code_write
Create branchCreates a Git branch from an existing branch or commit SHA.vso.code_write
Create pull requestCreates a pull request between branches.vso.code_write
Create wiki pageCreates a new Markdown page in a wiki.vso.wiki_write
Create work itemCreates a work item in a project.vso.work_write
Download wiki pageDownloads a wiki page as Markdown.vso.wiki
Find usersSearches identities by name or email for work-item assignment.vso.identity
Get current userReturns the signed-in Azure DevOps user profile.vso.profile
Get pull requestGets a pull request by project, repository, and ID, or by URL.vso.code
Get sprint capacityGets team member capacity and days off for a sprint.vso.work
Get wiki pageReads a wiki page by project, wiki, and page path.vso.wiki
Get work itemGets a work item by ID or URL.vso.work
Get work item commentsLists comments on a work item.vso.work
Get work item type schemaGets fields, allowed values, and states for a work item type.vso.work
List branchesLists Git branches in a repository.vso.code
List projectsLists projects the signed-in user can access.vso.project
List repositoriesLists Git repositories in a project or organization.vso.code
List sprintsLists iterations for a team in a project.vso.work
List teamsLists teams in the organization, optionally limited to one project.vso.project
List wiki pagesLists exact page paths in a wiki.vso.wiki
List wiki pages in folderLists Markdown pages in a wiki, including nested pages.vso.wiki
List wikisLists wikis in a project.vso.wiki
List work item typesLists work item types available in a project.vso.work
Merge pull requestCompletes a pull request into its target branch.vso.code_write
New work itemPolling trigger when a new work item is created.vso.work
Resolve projectResolves a project by name or ID.vso.project
Resolve teamResolves a team by name or ID.vso.project
Resolve wikiFinds a wiki, including project listing when the wiki is not already known.vso.wiki
vso.project
Resolve work itemResolves a work item by ID, URL, or title.vso.work
Search wikisSearches accessible wiki roots by project or wiki name.vso.wiki
vso.project
Search work itemsSearches work items, including a project lookup when a project filter is set.vso.work
vso.project
Update work itemUpdates fields on an existing work item.vso.work_write
Updated work itemPolling trigger when an existing work item is modified.vso.work