Azure DevOps Integration

Use Azure DevOps integration to let Dawn discover repositories, wikis, and work items from the projects your PAT can access.

Before you start

• Your Azure DevOps organization URL, usually https://dev.azure.com/your-org.
• A personal access token for the Azure DevOps account Dawn should use.
• Read access to the projects, repositories, wikis, and work items Dawn should discover.

Dawn currently connects to Azure DevOps with a personal access token. It does not use OAuth for this provider today.

Create the personal access token

1. Create a personal access token for the Azure DevOps account Dawn should use.
2. Prefer an organization-scoped PAT for the target organization.
3. Grant read access for the resource types you want Dawn to use.
4. Use Code: Read, Work Items: Read, and Wiki: Read as the usual starting point.
5. Copy the PAT and store it safely.

Connect Azure DevOps in Dawn

1. Open Integrations in Dawn and click Add connection.
2. Choose Azure DevOps.
3. Enter the organization URL.
4. Paste the PAT into Personal access token.
5. Click Connect.
6. Review the discovered sources and link the ones you want available in the workspace.
7. Assign those linked sources to the agents that should use them.

What Dawn discovers

Dawn discovers visible Azure DevOps projects, then creates repository sources, wiki sources, and one work item source per project.

Troubleshooting

• Connection fails: confirm the organization URL is correct and the PAT is active.
• Expected sources are missing: the PAT user likely cannot see that project or does not have the right read scope.
• Work items are missing: confirm the PAT has Work Items: Read and that the project was discovered.

Validate Azure DevOps source bindings for repos, work items, and wiki access.

Check that list/read operations resolve against the same Azure org metadata.