---
title: "Azure DevOps Integration"
description: "Connect TestOrchestrator to Azure DevOps with a Personal Access Token — reference Azure Boards work items from test objects and generate test cases from a work item."
source: "https://testorchestrator.com/docs/integrations/azure-devops"
---

# Azure DevOps Integration

Azure DevOps is a built-in integration source in TestOrchestrator. Once an administrator connects your Azure DevOps organisation, your team can reference an Azure Boards work item from a test case, run, or exploration, and point the AI test-case generator at a work item to draft cases that map to your project's template.

> Azure DevOps is a built-in [integration source](https://testorchestrator.com/docs/integrations/integration-sources). Everything about [relations](https://testorchestrator.com/docs/integrations/relations), project scope, and where links appear is shared with all other sources — this page covers what is specific to Azure DevOps.

## Connecting Azure DevOps in Settings

Azure DevOps is configured like any other source in **Admin → Integrations → Trackers**. The shared mechanics — the SOURCE, CAPABILITIES, and PROJECTS tabs, testing the connection, and enabling or disabling the source — are covered in [Trackers](https://testorchestrator.com/docs/integrations/integration-sources). The steps below cover what is specific to Azure DevOps.

1. In Azure DevOps, create a **Personal Access Token (PAT)** with permission to read work items.
2. In TestOrchestrator, open **Admin → Integrations → Trackers** and click **Create a source**. Choose **Azure DevOps** as the provider.
3. Set the **Base URL** to your Azure DevOps organisation and project.
4. For authentication, supply the **Personal Access Token (PAT)** as the access token credential.
5. **Test** the connection to confirm TestOrchestrator can reach Azure DevOps, then assign the source to **all projects** or to **specific projects** on the PROJECTS tab.

## Linking an Azure Boards work item

Once the Azure DevOps source is enabled for a project, members with permission to manage external references can link an Azure Boards work item to a test case, run, or exploration.

1. On a test case or run, click **Link issue**.
2. Type words from the work item’s title or its ID — Azure DevOps is searched along with the project’s other trackers — or paste the work item’s link.
3. On a test case, choose the [link type](https://testorchestrator.com/docs/integrations/relations) under **Link as**, then pick the work item.

Search needs a saved Personal Access Token and covers the source’s one project. Without a token, Azure DevOps is _link only_: paste the work item’s link or ID and the row shows _No details_. See [Linking issues](https://testorchestrator.com/docs/integrations/linking-issues) for the picker, the tracker chips and what each tracker can do.

## Generating test cases from a work item

Point the AI test-case generator at an Azure Boards work item to draft test cases that map to your project's template. Generation is initiated from inside TestOrchestrator. The drafted cases are created in the project you generate them into and can be reviewed and edited like any other test case.

> Test-case generation from a work item is an AI-assisted feature and is available on plans that include AI capabilities. Generated cases are drafts — always review them against the source work item before relying on them.

## Who can do what

| Action | Who can do it |
| --- | --- |
| Create, test, or disable the Azure DevOps source; assign projects | Admins with access to the Integrations admin page |
| Link an Azure Boards work item to a test object | Project members with permission to manage external references |
| Generate test cases from a work item | Project members with permission to generate test cases (AI plans only) |

## Related

- [Trackers](https://testorchestrator.com/docs/integrations/integration-sources) — How sources are configured, the authentication types available, capabilities, and project scope.
- [Link types](https://testorchestrator.com/docs/integrations/relations) — Define the semantic labels — General or Defect — applied to every external link.
