> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Azure DevOps

> Review the minimum OAuth scopes for every Azure DevOps action.

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

<Note>
  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.
</Note>

<div style={{overflowX: "auto"}}>
  <table style={{width: "100%", maxWidth: "100%", minWidth: 0, tableLayout: "fixed", whiteSpace: "normal", overflowWrap: "anywhere", wordBreak: "break-word"}}>
    <colgroup>
      <col style={{width: "20%"}} />

      <col style={{width: "25%"}} />

      <col style={{width: "55%"}} />
    </colgroup>

    <thead>
      <tr>
        <th style={{width: "20%"}}>Action</th>
        <th style={{width: "25%"}}>Description</th>
        <th style={{width: "55%"}}>Minimum scopes</th>
      </tr>
    </thead>

    <tbody>
      <tr>
        <td><strong>Add work item comment</strong></td>
        <td>Adds a comment to a work item.</td>
        <td><code>vso.work\_write</code></td>
      </tr>

      <tr>
        <td><strong>Check wiki page access</strong></td>
        <td>Checks whether the connected account can still read a wiki page.</td>
        <td><code>vso.wiki</code></td>
      </tr>

      <tr>
        <td><strong>Commit files</strong></td>
        <td>Pushes an atomic commit with file creates, edits, or deletes.</td>
        <td><code>vso.code\_write</code></td>
      </tr>

      <tr>
        <td><strong>Create branch</strong></td>
        <td>Creates a Git branch from an existing branch or commit SHA.</td>
        <td><code>vso.code\_write</code></td>
      </tr>

      <tr>
        <td><strong>Create pull request</strong></td>
        <td>Creates a pull request between branches.</td>
        <td><code>vso.code\_write</code></td>
      </tr>

      <tr>
        <td><strong>Create wiki page</strong></td>
        <td>Creates a new Markdown page in a wiki.</td>
        <td><code>vso.wiki\_write</code></td>
      </tr>

      <tr>
        <td><strong>Create work item</strong></td>
        <td>Creates a work item in a project.</td>
        <td><code>vso.work\_write</code></td>
      </tr>

      <tr>
        <td><strong>Download wiki page</strong></td>
        <td>Downloads a wiki page as Markdown.</td>
        <td><code>vso.wiki</code></td>
      </tr>

      <tr>
        <td><strong>Find users</strong></td>
        <td>Searches identities by name or email for work-item assignment.</td>
        <td><code>vso.identity</code></td>
      </tr>

      <tr>
        <td><strong>Get current user</strong></td>
        <td>Returns the signed-in Azure DevOps user profile.</td>
        <td><code>vso.profile</code></td>
      </tr>

      <tr>
        <td><strong>Get pull request</strong></td>
        <td>Gets a pull request by project, repository, and ID, or by URL.</td>
        <td><code>vso.code</code></td>
      </tr>

      <tr>
        <td><strong>Get sprint capacity</strong></td>
        <td>Gets team member capacity and days off for a sprint.</td>
        <td><code>vso.work</code></td>
      </tr>

      <tr>
        <td><strong>Get wiki page</strong></td>
        <td>Reads a wiki page by project, wiki, and page path.</td>
        <td><code>vso.wiki</code></td>
      </tr>

      <tr>
        <td><strong>Get work item</strong></td>
        <td>Gets a work item by ID or URL.</td>
        <td><code>vso.work</code></td>
      </tr>

      <tr>
        <td><strong>Get work item comments</strong></td>
        <td>Lists comments on a work item.</td>
        <td><code>vso.work</code></td>
      </tr>

      <tr>
        <td><strong>Get work item type schema</strong></td>
        <td>Gets fields, allowed values, and states for a work item type.</td>
        <td><code>vso.work</code></td>
      </tr>

      <tr>
        <td><strong>List branches</strong></td>
        <td>Lists Git branches in a repository.</td>
        <td><code>vso.code</code></td>
      </tr>

      <tr>
        <td><strong>List projects</strong></td>
        <td>Lists projects the signed-in user can access.</td>
        <td><code>vso.project</code></td>
      </tr>

      <tr>
        <td><strong>List repositories</strong></td>
        <td>Lists Git repositories in a project or organization.</td>
        <td><code>vso.code</code></td>
      </tr>

      <tr>
        <td><strong>List sprints</strong></td>
        <td>Lists iterations for a team in a project.</td>
        <td><code>vso.work</code></td>
      </tr>

      <tr>
        <td><strong>List teams</strong></td>
        <td>Lists teams in the organization, optionally limited to one project.</td>
        <td><code>vso.project</code></td>
      </tr>

      <tr>
        <td><strong>List wiki pages</strong></td>
        <td>Lists exact page paths in a wiki.</td>
        <td><code>vso.wiki</code></td>
      </tr>

      <tr>
        <td><strong>List wiki pages in folder</strong></td>
        <td>Lists Markdown pages in a wiki, including nested pages.</td>
        <td><code>vso.wiki</code></td>
      </tr>

      <tr>
        <td><strong>List wikis</strong></td>
        <td>Lists wikis in a project.</td>
        <td><code>vso.wiki</code></td>
      </tr>

      <tr>
        <td><strong>List work item types</strong></td>
        <td>Lists work item types available in a project.</td>
        <td><code>vso.work</code></td>
      </tr>

      <tr>
        <td><strong>Merge pull request</strong></td>
        <td>Completes a pull request into its target branch.</td>
        <td><code>vso.code\_write</code></td>
      </tr>

      <tr>
        <td><strong>New work item</strong></td>
        <td>Polling trigger when a new work item is created.</td>
        <td><code>vso.work</code></td>
      </tr>

      <tr>
        <td><strong>Resolve project</strong></td>
        <td>Resolves a project by name or ID.</td>
        <td><code>vso.project</code></td>
      </tr>

      <tr>
        <td><strong>Resolve team</strong></td>
        <td>Resolves a team by name or ID.</td>
        <td><code>vso.project</code></td>
      </tr>

      <tr>
        <td><strong>Resolve wiki</strong></td>
        <td>Finds a wiki, including project listing when the wiki is not already known.</td>
        <td><code>vso.wiki</code><br /><code>vso.project</code></td>
      </tr>

      <tr>
        <td><strong>Resolve work item</strong></td>
        <td>Resolves a work item by ID, URL, or title.</td>
        <td><code>vso.work</code></td>
      </tr>

      <tr>
        <td><strong>Search wikis</strong></td>
        <td>Searches accessible wiki roots by project or wiki name.</td>
        <td><code>vso.wiki</code><br /><code>vso.project</code></td>
      </tr>

      <tr>
        <td><strong>Search work items</strong></td>
        <td>Searches work items, including a project lookup when a project filter is set.</td>
        <td><code>vso.work</code><br /><code>vso.project</code></td>
      </tr>

      <tr>
        <td><strong>Update work item</strong></td>
        <td>Updates fields on an existing work item.</td>
        <td><code>vso.work\_write</code></td>
      </tr>

      <tr>
        <td><strong>Updated work item</strong></td>
        <td>Polling trigger when an existing work item is modified.</td>
        <td><code>vso.work</code></td>
      </tr>
    </tbody>
  </table>
</div>

## Related pages

* [Microsoft Integration Scopes](/en/admin/manage-integrations/microsoft-integration-scopes)
* [Microsoft integrations: permissions and admin approval](/en/admin/manage-integrations/integration-setup-guides/microsoft)