> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/miscellaneous-info/using-azure-devops-projects-as-workspaces.md).

# Using Azure Devops Projects as Workspaces

By default, Aikido treats your Azure Devops organization as a single environment. Some teams, however, use Azure Devops projects to organize their repositories and want each project to appear as its own workspace in Aikido. This guide explains how to set that up.

### Prerequisites

* You need to be an Azure Devops admin

{% hint style="warning" %}
The feature must be enabled by Aikido support. Contact us via chat to activate.
{% endhint %}

### Steps

1. **Create the global Azure Devops workspace in Aikido**
   * Go through the onboarding flow
   * No need to select any repositories here; this workspace will be used to split into other projects.
2. **Access the project-based onboarding link**
   * Go to <https://app.aikido.dev/onboarding/azure/connect-project-based-group>
3. **Enter your Azure Devops project name**
   * Provide the name of the project you want to create an Aikido workspace for.
4. **Select repositories**
   * Click **Next**, choose the repositories to include, and proceed.
5. **Finish setup**
   * Your project-based workspace is now created.
6. **Repeat for additional projects**
   * Switch back to your **global workspace** using the top-left dropdown.
   * Repeat from step 2 for each additional project.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.aikido.dev/miscellaneous-info/using-azure-devops-projects-as-workspaces.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.