> For the complete documentation index, see [llms.txt](https://docs.walnutai.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.walnutai.ai/overview-and-tracking/action-item/synchronizing-requirements-with-azure-devops.md).

# Synchronizing Requirements with Azure DevOps

Azure DevOps Synchronization enables seamless synchronization of requirements between WalnutAI and Azure DevOps, ensuring both platforms remain up to date without manual effort. You can configure one-way or two-way synchronization based on your workflow, allowing work items to be pulled from Azure DevOps, pushed from WalnutAI, or synchronized bidirectionally in real time. This helps maintain consistency, improves collaboration between business, development, and QA teams, and eliminates duplicate work.

**Steps for Azure DevOps Synchronization**

* Navigate to **Admin Settings.**

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

* Select the '**Azure** **Sync Configuration'** option.

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

* Select the **WalnutAI project** that is connected to Azure DevOps.

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

* Configure the required sync direction:
  * **WalnutAI → Azure DevOps** – Push requirements from WalnutAI to Azure DevOps.
  * **Azure DevOps → WalnutAI** – Pull work items from Azure DevOps into WalnutAI.
  * **Bidirectional Sync** – Enable both options to synchronize changes in both directions.

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

* Click **Sync**, then select **Start Sync** to begin the initial synchronization.

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

* Monitor the real-time synchronization progress until the sync is complete.

<figure><img src="/files/8F6cTju9nBsLXWyQO39c" alt=""><figcaption></figcaption></figure>

* Navigate to **Action Items** in WalnutAI to view the synchronized requirements. The same requirements will also be available in Azure DevOps.

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

* Keep **Live Sync** enabled to automatically synchronize new and updated requirements between WalnutAI and Azure DevOps.
* To stop automatic synchronization, navigate back to **Azure DevOps Sync Configuration** and disable the **Live Sync** toggle.

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

**Delete Behavior**

WalnutAI provides three options for handling deleted requirements during synchronization:

* **Unlink** – Removes the synchronization link without deleting the corresponding Azure DevOps work item.
* **Transition to Done/Closed** – Marks the linked Azure DevOps work item as **Done** or **Closed** instead of deleting it.
* **Delete Azure DevOps Work Item** – Permanently deletes the linked Azure DevOps work item when the requirement is deleted from WalnutAI.

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

Choose the delete behavior that best aligns with your team's workflow before enabling synchronization.