Skip to main content
Table of Contents

Integration Guide - Azure DevOps Repos

Connect Azure Repos Using a Personal Access Token (PAT). Connect Azure Repos to LinearB using a Personal Access Token so LinearB can read your repositories and activity for delivery metrics and autom…

heather.hazell
Updated by heather.hazell

Connect Azure Repos Using a Personal Access Token (PAT)

Connect Azure Repos to LinearB using a Personal Access Token so LinearB can read your repositories and activity for delivery metrics and automation.

Overview

Azure Repos is supported as a Git provider in LinearB. The connection uses an Azure DevOps Personal Access Token (PAT) with read-level scopes so LinearB can access your organization, projects, teams, code, builds, and graph data required to calculate metrics.

Before You Begin

Prerequisites
  • LinearB user with Admin permissions.
  • Azure DevOps account with sufficient rights to:
    • Create Personal Access Tokens.
    • Access the organization and projects you want LinearB to connect to.
Roles & Permissions
  • We recommend being an Organization Owner or having Project Collection Administrator permissions in Azure DevOps to ensure you can see all required projects and repos.
Security & Access

LinearB uses read-level access to analyze Git history and metadata. It does not modify your code or branches.

Expected Time to Complete
  • Approximately 5–10 minutes to create the PAT and connect Azure Repos to LinearB.

1. Generate a Personal Access Token in Azure DevOps

First, create a PAT in Azure DevOps that LinearB will use to access your Azure Repos.

Step-by-step: Create the PAT
  1. Navigate to Azure DevOps and sign in.
  2. Click your User Settings (top-right corner) and select Personal Access Tokens.
  3. Click + New Token.
  4. Provide a descriptive name for the token (for example, LinearB Azure Repos).
  5. Set an appropriate expiration date for the token, based on your security policies.
  6. Assign the following permissions:
    • User Profile: Read (vso.profile)
    • Project and Team: Read (vso.project)
    • Code: Read (vso.code)
    • Build: Read (vso.build)
    • Graph: Read (vso.graph)
  7. Click Create and copy the token securely (it will not be viewable again).

For more details on PAT creation and scope meanings, see Microsoft’s Azure DevOps PAT documentation.

2. Connect Azure Repos to LinearB

After you generate the PAT, use it to connect Azure Repos inside LinearB.

Step-by-step: Connect in LinearB
  1. In LinearB, navigate to Settings → Company Settings, and select the Git tab.
  2. Click Add Integration.
  3. Select Azure DevOps as your source control provider.
  4. Enter the name of your Azure DevOps organization.
  5. Paste your Personal Access Token (PAT) into the required field.
  6. Click Connect. LinearB will begin processing your Azure Repos data.

Verify

How to Confirm the Integration is Working
  • In LinearB, go to Settings → Company Settings → Git.
  • Confirm that an Azure DevOps integration appears with a connected status.
  • Click the integration entry to view available repositories and verify that your expected projects and repos are listed.
  • After initial processing, branches, commits, and pull requests from Azure Repos should begin to appear in your LinearB delivery and metrics views.

Troubleshooting

Problem Cause Fix
Azure DevOps connection fails PAT missing required scopes or incorrect organization name Confirm the organization name is correct and verify that the PAT includes the listed read scopes, then try connecting again.
Some projects or repos are not visible in LinearB Your Azure DevOps account/PAT doesn’t have access to those projects Ensure you are an organization owner or have Project Collection Administrator rights and that the PAT was created for the correct organization.
Integration previously worked but now shows errors PAT expired or was revoked Create a new PAT with the same scopes and repeat the connection steps in LinearB (or use a “Reauthorize” action if available).

If you continue to experience issues, please contact support

Next Steps

✅ You’ve successfully connected Azure Repos to LinearB using a Personal Access Token.

How did we do?

Git Integration - Start Here

Integration Guide - Bitbucket (Cloud + Server)

Contact