# Azure DevOps (ADO)

### Add Git connection

To add Azure DevOps personal git tokens in Brainboard, you first need to generate an Azure DevOps personal access token.

<details>

<summary>Steps to generate a personal access token on your <strong>Azure DO</strong> account.</summary>

1. Go to your [Azure DO page](https://dev.azure.com/).
2. Click on the top right icon and then select `Personal access tokens`:&#x20;

   <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2Fgit-blob-6b0dab91965c80cda1b7e0bad72563974ec16665%2Fazure-devops-pat.png?alt=media" alt=""><figcaption></figcaption></figure>
3. It will open the page of access tokens. Click on `New token` button.&#x20;

   <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2Fgit-blob-bb8ae5d6e1e72e6db1be9ec5d182b588e7490f31%2Fazure-devops-add-pat.png?alt=media" alt=""><figcaption></figcaption></figure>
4. In the menu, add the following information:
   * Name of the token.
   * You can set an expiration date.
   * In the `code` section, select `Full`&#x20;

     <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2Fgit-blob-c2341912c3895fab796b78d16a0480e57986e388%2Fazure-devops-pat-menu.png?alt=media" alt=""><figcaption></figcaption></figure>
5. The token is generated, you can copy it to add to Brainboard:&#x20;

   <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2Fgit-blob-6f7b2ebf87a07b15cead08861bdb226731435732%2Fazure-do-token-generated.png?alt=media" alt=""><figcaption></figcaption></figure>

</details>

To add the generated token in Brainboard:

1. Go to the [Git integration](https://app.brainboard.co/settings/integrations/git) settings page.
2. Click on `Integrations`
3. In the section `Personal connections` Click on `Add connection`&#x20;
4. Select `Azure DevOps` tab<br>

   <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FfZ0C0dLvFDD4z0ExofnN%2FCleanShot%202025-04-11%20at%2016.56.12%402x.png?alt=media&#x26;token=8be2a430-c949-4442-938b-906f81f820d8" alt=""><figcaption></figcaption></figure>
5. Add your credentials in the displayed window:
   * Name of the token. This is only for Brainboard, it will not be used when you do a pull request.
   * The URL of your Azure DevOps organization.
     * To get this URL, the simplest way is to click on `Azure DevOps` on the top-left button then copy the URL of the browser&#x20;

       <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2Fgit-blob-0c2d35443ce47ff8c80d7d4d7a7651038f6cb397%2Fazure-do-orga-url.png?alt=media" alt=""><figcaption></figcaption></figure>
   * Token: the token (secret) generated from your Azure DO account.&#x20;
6. Then click on `Save and close` button.
7. Brainboard will verify if the credentials are valid:
   1. If they are valid, Brainboard displays a success message and you can see the integration now in the Git connection page<br>

      <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2Fpra8KE7gQGR5DC2nb3nn%2FCleanShot%202025-04-11%20at%2017.07.55%402x.png?alt=media&#x26;token=7628f78c-bf93-4f36-a57b-45f561a58ad6" alt=""><figcaption></figcaption></figure>
   2. If they are not, you'll receive an error about what is wrong. For example:<br>

      <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2Fdv9hKKZaTDhRnJqibfML%2FCleanShot%202025-04-11%20at%2017.00.18%402x.png?alt=media&#x26;token=48bcd08a-1c9d-4464-abdb-b425d22e4f0d" alt=""><figcaption></figcaption></figure>

      <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2Fqnr5EInAOYsKxrKSgPNJ%2FCleanShot%202025-04-11%20at%2017.03.42%402x.png?alt=media&#x26;token=80ab95d5-8278-4f87-8183-e778449c6a4c" alt=""><figcaption></figcaption></figure>

### How to use

Please refer to the page [pull-requests](https://docs.brainboard.co/settings/integrations/git-configuration/pull-requests "mention") to understand how you can use your git connections whether you want to do a pull request and import your code from Git.

### Edit or delete connection

1. Go to the [Git integration](https://app.brainboard.co/settings/integrations/git) settings page.
2. Click on `Integrations`
3. In the section `Personal connections` Click on the `Azure DevOps` integration that you want to edit or delete
4. Select the action you want to perform from the view

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2F7Xo9wsE6Ema1tp5DE5pk%2FCleanShot%202025-04-11%20at%2017.05.05%402x.png?alt=media&#x26;token=d7ea889a-1465-44d9-bf91-c283b503b9d1" alt=""><figcaption></figcaption></figure>
