Azure DevOps

Azure DevOps Services REST API for an organization’s repos, pull requests, work items (Boards), and pipelines (CI/CD). Use when an agent needs to list projects and repositories, open or update pull requests, query and read work items via WIQL, or trigger and inspect pipeline runs and builds. Microsoft’s enterprise dev platform — the counterpart to GitHub for teams standardized on Azure DevOps; calls run under the connected user’s own ADO permissions. 12 example endpoints available through Lava’s AI Gateway. See the Azure DevOps API docs for full documentation.

This provider requires your own credentials — connect your API key or OAuth account before use.

This is a catch-all provider — any valid URL under https://dev.azure.com is supported. Azure DevOps Services REST API. Construct URLs as https://dev.azure.com/{organization}/{project}/_apis/{area}/{resource}?api-version=7.1 — the api-version query param is REQUIRED on every call (omitting it returns a 400/203). Org-level resources drop the {project} segment (e.g. https://dev.azure.com/{organization}/_apis/projects?api-version=7.1). Some resources live on subdomains: identities/profiles on vssps.dev.azure.com, Analytics OData on analytics.dev.azure.com, package feeds on feeds.dev.azure.com. Common areas: git/repositories, git/pullrequests, wit/workitems, wit/wiql, build/builds, pipelines, wiki/wikis. Non-GET calls require a JSON body — for DELETE send an empty object as body_json. NOTE: creating or updating work items uses the JSON Patch media type (application/json-patch+json), which this provider cannot send (it forces application/json); read, query (WIQL), and delete work items are supported, and pull requests / pipelines / wiki use plain JSON. See https://learn.microsoft.com/en-us/rest/api/azure/devops/ for the full reference. The endpoints below are curated examples.

Endpoints

List the projects in an organization. A cheap first call after connect to discover project names for later paths.

GET https://dev.azure.com/{organization}/_apis/projects?api-version=7.1 — Free

SDK
cURL

const data = await lava.gateway('https://dev.azure.com/{organization}/_apis/projects?api-version=7.1', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdev.azure.com%2F%7Borganization%7D%2F_apis%2Fprojects%3Fapi-version%3D7.1" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List the Git repositories in a project.

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=7.1 — Free

SDK
cURL

const data = await lava.gateway('https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=7.1', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdev.azure.com%2F%7Borganization%7D%2F%7Bproject%7D%2F_apis%2Fgit%2Frepositories%3Fapi-version%3D7.1" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List pull requests in a repository. Filter with searchCriteria.status (active, completed, abandoned) and searchCriteria.targetRefName.

GET

https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests?searchCriteria.status=active&api-version=7.1

— Free

SDK
cURL

const data = await lava.gateway('https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests?searchCriteria.status=active&api-version=7.1', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdev.azure.com%2F%7Borganization%7D%2F%7Bproject%7D%2F_apis%2Fgit%2Frepositories%2F%7BrepositoryId%7D%2Fpullrequests%3FsearchCriteria.status%3Dactive%26api-version%3D7.1" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Read a single work item by ID. Add &$expand=all for fields, relations, and links.

GET https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?api-version=7.1 — Free

SDK
cURL

const data = await lava.gateway('https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?api-version=7.1', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdev.azure.com%2F%7Borganization%7D%2F%7Bproject%7D%2F_apis%2Fwit%2Fworkitems%2F%7Bid%7D%3Fapi-version%3D7.1" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List the pipelines defined in a project.

GET https://dev.azure.com/{organization}/{project}/_apis/pipelines?api-version=7.1 — Free

SDK
cURL

const data = await lava.gateway('https://dev.azure.com/{organization}/{project}/_apis/pipelines?api-version=7.1', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdev.azure.com%2F%7Borganization%7D%2F%7Bproject%7D%2F_apis%2Fpipelines%3Fapi-version%3D7.1" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List builds in a project. Filter with definitions, statusFilter (inProgress, completed), and resultFilter (succeeded, failed).

GET https://dev.azure.com/{organization}/{project}/_apis/build/builds?statusFilter=completed&api-version=7.1 — Free

SDK
cURL

const data = await lava.gateway('https://dev.azure.com/{organization}/{project}/_apis/build/builds?statusFilter=completed&api-version=7.1', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdev.azure.com%2F%7Borganization%7D%2F%7Bproject%7D%2F_apis%2Fbuild%2Fbuilds%3FstatusFilter%3Dcompleted%26api-version%3D7.1" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Run a WIQL query to find work items. Returns matching work item IDs (and references) — read full fields with the get-work-item endpoint. The workhorse for “find/list” questions over Boards.

POST https://dev.azure.com/{organization}/{project}/_apis/wit/wiql?api-version=7.1 — Free

SDK
cURL

const data = await lava.gateway('https://dev.azure.com/{organization}/{project}/_apis/wit/wiql?api-version=7.1', {
  body: {
"query": "SELECT [System.Id], [System.Title], [System.State] FROM WorkItems WHERE [System.WorkItemType] = 'Bug' AND [System.State] <> 'Closed' ORDER BY [System.ChangedDate] DESC"
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdev.azure.com%2F%7Borganization%7D%2F%7Bproject%7D%2F_apis%2Fwit%2Fwiql%3Fapi-version%3D7.1" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"SELECT [System.Id], [System.Title], [System.State] FROM WorkItems WHERE [System.WorkItemType] = '\''Bug'\'' AND [System.State] <> '\''Closed'\'' ORDER BY [System.ChangedDate] DESC"}'

Open a pull request. sourceRefName and targetRefName are full ref names (refs/heads/{branch}).

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests?api-version=7.1 — Free

SDK
cURL

const data = await lava.gateway('https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests?api-version=7.1', {
  body: {
"sourceRefName": "refs/heads/feature/login",
"targetRefName": "refs/heads/main",
"title": "Add login flow",
"description": "Implements the login flow and tests."
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdev.azure.com%2F%7Borganization%7D%2F%7Bproject%7D%2F_apis%2Fgit%2Frepositories%2F%7BrepositoryId%7D%2Fpullrequests%3Fapi-version%3D7.1" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sourceRefName":"refs/heads/feature/login","targetRefName":"refs/heads/main","title":"Add login flow","description":"Implements the login flow and tests."}'

Queue a run of a pipeline. Optionally target a branch via resources.repositories.self.refName.

POST https://dev.azure.com/{organization}/{project}/_apis/pipelines/{pipelineId}/runs?api-version=7.1 — Free

SDK
cURL

const data = await lava.gateway('https://dev.azure.com/{organization}/{project}/_apis/pipelines/{pipelineId}/runs?api-version=7.1', {
  body: {
"resources": {
  "repositories": {
    "self": {
      "refName": "refs/heads/main"
    }
  }
}
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdev.azure.com%2F%7Borganization%7D%2F%7Bproject%7D%2F_apis%2Fpipelines%2F%7BpipelineId%7D%2Fruns%3Fapi-version%3D7.1" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"resources":{"repositories":{"self":{"refName":"refs/heads/main"}}}}'

Update a pull request — e.g. complete it, abandon it (status), or change its title/description.

PATCH

https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests/{pullRequestId}?api-version=7.1

— Free

SDK
cURL

const data = await lava.gateway('https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests/{pullRequestId}?api-version=7.1', {
  method: 'PATCH',
  body: {
"status": "completed",
"completionOptions": {
  "deleteSourceBranch": true
}
},
});

curl -X PATCH "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdev.azure.com%2F%7Borganization%7D%2F%7Bproject%7D%2F_apis%2Fgit%2Frepositories%2F%7BrepositoryId%7D%2Fpullrequests%2F%7BpullRequestId%7D%3Fapi-version%3D7.1" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"completed","completionOptions":{"deleteSourceBranch":true}}'

Create or update a wiki page at the given path. To update an existing page, send the current version as the If-Match ETag.

PUT

https://dev.azure.com/{organization}/{project}/_apis/wiki/wikis/{wikiIdentifier}/pages?path=/Release%20Notes&api-version=7.1

— Free

SDK
cURL

const data = await lava.gateway('https://dev.azure.com/{organization}/{project}/_apis/wiki/wikis/{wikiIdentifier}/pages?path=/Release%20Notes&api-version=7.1', { method: 'PUT', body: {"content":"# Release Notes\n\nShipped the login flow."} });

curl -X PUT "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdev.azure.com%2F%7Borganization%7D%2F%7Bproject%7D%2F_apis%2Fwiki%2Fwikis%2F%7BwikiIdentifier%7D%2Fpages%3Fpath%3D%2FRelease%2520Notes%26api-version%3D7.1" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content":"# Release Notes\n\nShipped the login flow."}'

Delete a work item (moves it to the project Recycle Bin). The gateway requires a JSON body on every non-GET call, so send an empty object as body_json.

DELETE https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?api-version=7.1 — Free

SDK
cURL

const data = await lava.gateway('https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?api-version=7.1', { method: 'DELETE', body: {} });

curl -X DELETE "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdev.azure.com%2F%7Borganization%7D%2F%7Bproject%7D%2F_apis%2Fwit%2Fworkitems%2F%7Bid%7D%3Fapi-version%3D7.1" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Endpoints

List the projects in an organization. A cheap first call after connect to discover project names for later paths.

List the Git repositories in a project.

List pull requests in a repository. Filter with searchCriteria.status (active, completed, abandoned) and searchCriteria.targetRefName.

Read a single work item by ID. Add &$expand=all for fields, relations, and links.

List the pipelines defined in a project.

List builds in a project. Filter with definitions, statusFilter (inProgress, completed), and resultFilter (succeeded, failed).

Run a WIQL query to find work items. Returns matching work item IDs (and references) — read full fields with the get-work-item endpoint. The workhorse for “find/list” questions over Boards.

Open a pull request. sourceRefName and targetRefName are full ref names (refs/heads/{branch}).

Queue a run of a pipeline. Optionally target a branch via resources.repositories.self.refName.

Update a pull request — e.g. complete it, abandon it (status), or change its title/description.

Create or update a wiki page at the given path. To update an existing page, send the current version as the If-Match ETag.

Delete a work item (moves it to the project Recycle Bin). The gateway requires a JSON body on every non-GET call, so send an empty object as body_json.

Next Steps

All Providers

Forward Proxy

​Endpoints

​List the projects in an organization. A cheap first call after connect to discover project names for later paths.

​List the Git repositories in a project.

​List pull requests in a repository. Filter with searchCriteria.status (active, completed, abandoned) and searchCriteria.targetRefName.

​Read a single work item by ID. Add &$expand=all for fields, relations, and links.

​List the pipelines defined in a project.

​List builds in a project. Filter with definitions, statusFilter (inProgress, completed), and resultFilter (succeeded, failed).

​Run a WIQL query to find work items. Returns matching work item IDs (and references) — read full fields with the get-work-item endpoint. The workhorse for “find/list” questions over Boards.

​Open a pull request. sourceRefName and targetRefName are full ref names (refs/heads/{branch}).

​Queue a run of a pipeline. Optionally target a branch via resources.repositories.self.refName.

​Update a pull request — e.g. complete it, abandon it (status), or change its title/description.

​Create or update a wiki page at the given path. To update an existing page, send the current version as the If-Match ETag.

​Delete a work item (moves it to the project Recycle Bin). The gateway requires a JSON body on every non-GET call, so send an empty object as body_json.

​Next Steps

All Providers

Forward Proxy

Endpoints

List the projects in an organization. A cheap first call after connect to discover project names for later paths.

List the Git repositories in a project.

List pull requests in a repository. Filter with searchCriteria.status (active, completed, abandoned) and searchCriteria.targetRefName.

Read a single work item by ID. Add &$expand=all for fields, relations, and links.

List the pipelines defined in a project.

List builds in a project. Filter with definitions, statusFilter (inProgress, completed), and resultFilter (succeeded, failed).

Run a WIQL query to find work items. Returns matching work item IDs (and references) — read full fields with the get-work-item endpoint. The workhorse for “find/list” questions over Boards.

Open a pull request. sourceRefName and targetRefName are full ref names (refs/heads/{branch}).

Queue a run of a pipeline. Optionally target a branch via resources.repositories.self.refName.

Update a pull request — e.g. complete it, abandon it (status), or change its title/description.

Create or update a wiki page at the given path. To update an existing page, send the current version as the If-Match ETag.

Delete a work item (moves it to the project Recycle Bin). The gateway requires a JSON body on every non-GET call, so send an empty object as body_json.

Next Steps