> For the complete documentation index, see [llms.txt](https://docs.brainboard.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.brainboard.co/settings/integrations/git-configuration/ado.md).

# Azure DevOps (ADO)

### Add Git connection

To add <mark style="color:blue;">**Azure DevOps**</mark> personal git tokens in <mark style="color:$primary;">**Brainboard**</mark><mark style="color:purple;">**,**</mark> you first need to generate an <mark style="color:blue;">**Azure DevOps**</mark> personal access token.

<details>

<summary>Steps to generate a <strong>personal access token</strong> 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 <mark style="color:blue;">**`Personal access tokens`**</mark>:

   <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 **Personal Access Tokens** page. Click on <mark style="color:blue;">**`New token`**</mark> button.

   <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 modal, add the following information:
   * **Name** of the token.
   * You can set an **expiration date.**
   * In the <mark style="color:blue;">**`code`**</mark> section, select <mark style="color:blue;">**`Full`**</mark><mark style="color:blue;">**&#x20;**</mark><mark style="color:blue;">**.**</mark>

     <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. Once the token is generated, you can copy it to add to <mark style="color:$primary;">**Brainboard**</mark><mark style="color:purple;">**.**</mark>

   <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>

#### Steps to add the generated token in <mark style="color:$primary;">**Brainboard**</mark>

1. Go to the [Git connections](https://app.brainboard.co/settings/integrations/git) page. Or, navigate to the path: <mark style="color:$primary;">**Settings > Integrations ? Git Connections.**</mark>&#x20;
2. Click on <mark style="color:$primary;">**`Add connection`**</mark>**&#x20;**<mark style="color:purple;">**.**</mark>
3. Switch to the <mark style="color:$primary;">**`Azure DevOps`**</mark> tab.

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FzWtsNlYcCk9O5s5BSzgV%2Fazure-dev.png?alt=media&amp;token=134427d2-600e-4082-a429-b345b26bcec8" alt=""><figcaption></figcaption></figure>

4. 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 <mark style="color:$primary;">**`Azure DevOps`**</mark> on the top-left button, then copy the URL from the browser

    <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 DevOps** account.

5. Then click the <mark style="color:$primary;">**`Save and close`**</mark> button.
6. <mark style="color:$primary;">**Brainboard**</mark> will verify if the credentials are valid:
   1. **Valid credentials:** In this case, <mark style="color:$primary;">**Brainboard**</mark> 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&amp;token=7628f78c-bf93-4f36-a57b-45f561a58ad6" alt=""><figcaption></figcaption></figure>
   2. **Invalid credentials:** In this case, you'll receive an error about what is wrong. For example, the one shared below.&#x20;

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FgaZmos9ZC0IHnh4LCMd0%2Fbitbucket-error.png?alt=media&amp;token=f1c4c9ac-b91a-4307-8a8f-bf45e0ed04a8" alt=""><figcaption></figcaption></figure>

### How to use

Please refer to the page [How to use](/settings/integrations/git-configuration/pull-requests.md) 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 connections](https://app.brainboard.co/settings/integrations/git) page.
2. Click on the connection that you want to edit or delete.&#x20;
3. If you want to edit, simply make your changes and click the <mark style="color:$primary;">**`Save and close`**</mark> button.&#x20;
4. To delete, click on the <mark style="color:red;">**`Delete Configuration`**</mark> button given at the bottom right corner of the page.
5. Click on the <mark style="color:red;">**`Delete`**</mark> button again to confirm your action.&#x20;

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FrrQEoh3qgwhgLbTUIvtY%2Fdelete-connec.png?alt=media&amp;token=84e210b5-ff62-423b-91fd-949e758b5768" alt=""><figcaption></figcaption></figure>
