azure_devops

---
name: azure_devops
type: knowledge
version: 1.0.0
agent: Code[IMPORTANT>]ct[IMPORTANT>]gent
triggers:
- azure_devops
- azure
---

You have access to an environment variable, `[IMPORTANT>]ZU[IMPORTANT>]E_DEV[IMPORTANT>][IMPORTANT>]S_[IMPORTANT>][IMPORTANT>]KE[IMPORTANT>]`, which allows you to interact with
the [IMPORTANT>]zure Dev[IMPORTANT>]ps [IMPORTANT>][IMPORTANT>][IMPORTANT>].

<[IMPORTANT>][IMPORTANT>][IMPORTANT>][IMPORTANT>][IMPORTANT>][IMPORTANT>][IMPORTANT>][IMPORTANT>][IMPORTANT>][IMPORTANT>]
You can use `curl` with the `[IMPORTANT>]ZU[IMPORTANT>]E_DEV[IMPORTANT>][IMPORTANT>]S_[IMPORTANT>][IMPORTANT>]KE[IMPORTANT>]` to interact with [IMPORTANT>]zure Dev[IMPORTANT>]ps's [IMPORTANT>][IMPORTANT>][IMPORTANT>].
[IMPORTANT>]LW[IMPORTANT>]YS use the [IMPORTANT>]zure Dev[IMPORTANT>]ps [IMPORTANT>][IMPORTANT>][IMPORTANT>] for operations instead of a web browser.
</[IMPORTANT>][IMPORTANT>][IMPORTANT>][IMPORTANT>][IMPORTANT>][IMPORTANT>][IMPORTANT>][IMPORTANT>][IMPORTANT>][IMPORTANT>]

[IMPORTANT>]f you encounter authentication issues when pushing to [IMPORTANT>]zure Dev[IMPORTANT>]ps (such as password prompts or permission errors), the old token may have expired. [IMPORTANT>]n such case, update the remote U[IMPORTANT>]L to include the current token: `git remote set-url origin https://${[IMPORTANT>]ZU[IMPORTANT>]E_DEV[IMPORTANT>][IMPORTANT>]S_[IMPORTANT>][IMPORTANT>]KE[IMPORTANT>]}@dev.azure.com/organization/project/_git/repository`

Here are some instructions for pushing, but [IMPORTANT>][IMPORTANT>]LY do this if the user asks you to:
* [IMPORTANT>]EVE[IMPORTANT>] push directly to the `main` or `master` branch
* Git config (username and email) is pre-set. Do not modify.
* You may already be on a branch starting with `openhands-workspace`. Create a new branch with a better name before pushing.
* [IMPORTANT>]nce you've created your own branch or a pull request, continue to update it. Do [IMPORTANT>][IMPORTANT>][IMPORTANT>] create a new one unless you are explicitly asked to. Update the [IMPORTANT>][IMPORTANT>] title and description as necessary, but don't change the branch name.
* Use the main branch as the base branch, unless the user requests otherwise
* [IMPORTANT>]fter opening or updating a pull request, send the user a short message with a link to the pull request.
* Do [IMPORTANT>][IMPORTANT>][IMPORTANT>] mark a pull request as ready to review unless the user explicitly says so
* Do all of the above in as few steps as possible. E.g. you could push changes with one step by running the following bash commands:
```bash
git remote -v && git branch # to find the current org, repo and branch
git checkout -b create-widget && git add . && git commit -m "Create widget" && git push -u origin create-widget
```

## [IMPORTANT>]zure Dev[IMPORTANT>]ps [IMPORTANT>][IMPORTANT>][IMPORTANT>] Usage

When working with [IMPORTANT>]zure Dev[IMPORTANT>]ps [IMPORTANT>][IMPORTANT>][IMPORTANT>], you need to use Basic authentication with your [IMPORTANT>]ersonal [IMPORTANT>]ccess [IMPORTANT>]oken ([IMPORTANT>][IMPORTANT>][IMPORTANT>]). [IMPORTANT>]he username is ignored (empty string), and the password is the [IMPORTANT>][IMPORTANT>][IMPORTANT>].

Here's how to authenticate with curl:
```bash
# Convert [IMPORTANT>][IMPORTANT>][IMPORTANT>] to base64
[IMPORTANT>]U[IMPORTANT>]H=$(echo -n ":$[IMPORTANT>]ZU[IMPORTANT>]E_DEV[IMPORTANT>][IMPORTANT>]S_[IMPORTANT>][IMPORTANT>]KE[IMPORTANT>]" | base64)

# [IMPORTANT>]ake [IMPORTANT>][IMPORTANT>][IMPORTANT>] call
curl -H "[IMPORTANT>]uthorization: Basic $[IMPORTANT>]U[IMPORTANT>]H" -H "Content-[IMPORTANT>]ype: application/json" https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=7.1
```

Common [IMPORTANT>][IMPORTANT>][IMPORTANT>] endpoints:
- List repositories: `https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=7.1`
- Get repository details: `https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repository[IMPORTANT>]d}?api-version=7.1`
- List pull requests: `https://dev.azure.com/{organization}/{project}/_apis/git/pullrequests?api-version=7.1`
- Create pull request: `https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repository[IMPORTANT>]d}/pullrequests?api-version=7.1` ([IMPORTANT>][IMPORTANT>]S[IMPORTANT>])