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

# Azure Boards

> Connect an Azure DevOps project so that Datafold can file and update work items with a service account's personal access token.

> [!NOTE]
>
> Issue trackers are in preview and are enabled per organization. Ask your Datafold contact or [support@datafold.com](mailto:support@datafold.com) to turn them on.

Datafold files and updates Azure DevOps work items with the personal access token of a service account, not as you. One Azure DevOps project connects to one Datafold organization. Datafold supports Azure DevOps Services and Azure DevOps Server.

## 1. Create a service account and a token

**1. Add a user for Datafold**

In your Azure DevOps organization (or collection, on Azure DevOps Server), add a user for Datafold with **Basic** access. **Stakeholder** access cannot add the tags that Datafold uses to find its work items again.

**2. Add it to the project**

Add that user to the **Contributors** group of the project that Datafold will use.

**3. Create a personal access token**

Sign in as that user. Open **User settings** → **Personal access tokens**, and create a token for this organization with these scopes:

* **Work Items**: **Read & write**
* **Project and Team**: **Read**
* **Identity**: **Read** (optional; lets Datafold @mention people in comments)

Copy the token. Azure DevOps shows it only once.

## 2. Connect Azure Boards in Datafold

Go to **Settings** → **Integrations** → **Issue Trackers**, click **Add new integration**, and choose **Azure Boards**. Fill in the form and click **Connect**:

* **Organization URL**: the address of your organization, for example `https://dev.azure.com/your-organization`. On Azure DevOps Server, use the address of the collection, for example `https://ado.example.com/tfs/DefaultCollection`. The address must start with `https://`.
* **Project**: the name of the Azure DevOps project.
* **Personal/Project Access Token**: the personal access token from step 1.

## Replace the token

If Azure DevOps refuses the token (it expired or was revoked), the page shows **Azure DevOps refused the token**. Create a new personal access token for the service account, enter it in the form, and click **Update token**.

## Disconnect

**Disconnect** makes Datafold forget the token. Datafold cannot revoke it, so revoke the service account's personal access token yourself in Azure DevOps. It stays valid until you do or until it expires.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.