# Azure Boards

**Data Access by Hivel**

* Hivel accesses the past 60-90 days of commits and pull requests from active repositories during the initial sync.

**Authorization Mechanism**

* Hivel gets access using a Personal Access Token, which can be created using this [<mark style="color:purple;">link</mark>](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops\&tabs=Windows#create-a-pat).
* Users maintain full control and can withdraw access anytime by revoking the Personal Access Token.
* Ensure '**All accessible organizations'** is selected while creating the Personal Access Token.\
  \
  ![](/files/5bsIeaAHigAxVjc61Un2)\
  ![](/files/jvh2097XEYjx7KlYM8Do)\
  ![](/files/1xMex23YWEy2vuuccDFH)

<figure><img src="/files/4YA9ThGWZc8kATvx3DBz" alt=""><figcaption></figcaption></figure>

**Requirements**

* Ensure to create the Personal Access Token from an account that has "Project Administrator" permissions for all relevant projects and repositories.

**Best Practice**

* Opt for a service account rather than an individual-linked account.
* Service accounts are typically overseen by the company's admin.

**Personal Access Token Permissions**

* Please ensure you select all the options below while creating a Personal Access Token.
  * **Project And Team**: Read&#x20;
  * **User Profile**: Read&#x20;
  * **Code**: Read&#x20;
  * **Build**: Read&#x20;
  * **Graph:** Read&#x20;
  * **Work Items:** Read \
    \
    ![](/files/Vw528zHKkUMLE6zKCOUH)\
    ![](/files/SOqcRpfqtjs7YRjtkxKn)\
    ![](/files/zXkkAZjscpk3lYZx7vRb)\
    ![](/files/DsH0QHETHIxgSJguTnph)\
    ![](/files/iOssU43SBMORBoqx5yXI)\
    ![](/files/qFdKUGpp7QdZ9CnXCW4d)

**You are almost done.**

* Once a Personal Access Token is created, please copy it and share it with the Hivel team.
* You will receive an email from the Hivel team once your data is all up and running.


---

# 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.hivel.ai/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.
