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

# Azure DevOps

> Connect Azure DevOps Boards and Test Plans to Felan with a team-scoped PAT.

The Azure DevOps integration gives a Felan team access to Azure Boards and Azure Test Plans through one organization URL and personal access token (PAT).

## Setup

<Steps>
  <Step title="Create a PAT">
    In Azure DevOps, create a PAT with **Work Items: Read & write** and **Test Management: Read & write** access for the target organization.
  </Step>

  <Step title="Open Integrations">
    Select the Felan team that should use Azure DevOps, then open **Integrations** from the main navigation.
  </Step>

  <Step title="Connect Azure DevOps">
    Find **Azure DevOps**, click **Connect**, and enter the organization URL and PAT in the provider form.
  </Step>
</Steps>

## Supported behavior

### Azure Boards

* Search and read work items
* Create and update work items when requested
* Add comments to work items

### Azure Test Plans

* List and create test plans and static suites
* List, create, and update manual test cases and steps
* Add test cases to suites and resolve test points
* Create runs from test points, update result outcomes, and complete runs

Felan preserves Azure identifiers returned by the provider so later operations address the same plans, suites, cases, points, runs, and results.

## Troubleshooting

**No Azure projects are returned** — Confirm that the PAT owner can access the organization and target Azure project.

**Test Plans operations are forbidden** — Recreate or update the PAT with **Test Management: Read & write**.

**Work item operations are forbidden** — Confirm **Work Items: Read & write** and the PAT owner's project permissions.