# Azure Boards

## ![](/files/kdCo4mqTJaw5In7Jq4BM)

## Set up

### Navigate to the Integration settings view

1. Select an app in the top left corner from the Switcher
2. Navigate to **App Settings** by clicking the gear icon (⚙️) at the top of the Timeline sidebar
3. Click on **Integrations** in the sidebar

### **Connect Azure Boards**

* Find the **Azure Boards** integration module under the **Project management** section
* Click the **Connect** button
* You’ll be taken through a standard Azure DevOps OAuth flow

{% hint style="warning" %}
You must be logged in to Azure DevOps with a user that has access to the organization/project you want to connect.
{% endhint %}

{% hint style="warning" %}
Make sure the **Third-party application access via OAuth** toggle is enabled from **Organization Settings > Policies** in Azure DevOps (see below)
{% endhint %}

<figure><img src="/files/TxarRl0pyuiMXxGwZDdr" alt=""><figcaption></figcaption></figure>

* Azure Boards redirects you back to Runway, Runway presents a dialog:
  1. Select the project you want to connect from the dropdown of options
  2. Optionally select any specific Azure Area Paths that contain work items that are in scope for this app (if no specific Area Paths are specified, Runway will consider all work items in the project)
  3. Optionally select any *additional* columns that signify a “done” state for your work items (any columns marked as "done" states by Azure Boards are automatically treated as such by Runway)

### Add feature affiliations

* Specify the tags that Runway should use to associate work items with specific releases
* Pattern is tokenized with the release version, *e.g.* `ios-{version}`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.runway.team/integrations/project-management/azure-boards.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.