# Azure DevOps — Pipedream Connect

> Plan smarter, collaborate better, and ship faster with a set of modern dev services

- API slug: `azure_devops` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Infrastructure & Cloud
- Website: https://azure.microsoft.com/en-us/products/devops/
- Managed OAuth scopes: `vso.analytics` · `vso.auditlog` · `vso.build_execute` · `vso.code_manage` · `vso.dashboards_manage` · `vso.entitlements` · `vso.extension.data_write` · `vso.extension_manage` · `vso.gallery_manage` · `vso.graph_manage` · `vso.identity_manage` · `vso.loadtest_write` · `vso.machinegroup_manage` · `vso.memberentitlementmanagement_write` · `vso.notification_diagnostics` · `vso.notification_manage` · `vso.packaging_manage` · `vso.profile_write` · `vso.project_manage` · `vso.release_manage` · `vso.serviceendpoint_manage` · `vso.symbols_manage` · `vso.taskgroups_manage` · `vso.test_write` · `vso.threads_full` · `vso.variablegroups_manage` · `vso.wiki_write` · `vso.work_full`
- This page (HTML): https://pipedream.com/apps/azure-devops
- Tools: 73 actions · 1 trigger

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: azure_devops`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "azure_devops",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Add Pull Request Reviewer:
const result = await mcp.callTool({
  name: "azure_devops-add-pull-request-reviewer",
  arguments: {
    organization: "Organization",
    project: "Project",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Azure DevOps endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://app.vssps.visualstudio.com/_apis/profile/profiles/Me

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcHAudnNzcHMudmlzdWFsc3R1ZGlvLmNvbS9fYXBpcy9wcm9maWxlL3Byb2ZpbGVzL01l?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "azure_devops-add-pull-request-reviewer",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    azure_devops: { authProvisionId: "apn_xxxxxxx" },
    organization: "Organization",
    project: "Project",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (73)

### `azure_devops-add-pull-request-reviewer` — Add Pull Request Reviewer (Write)

Add a reviewer to a pull request, optionally marking them required or casting their vote. Returns the reviewer entry including their current vote. Use this to route a pull request to the right owner automatically. Example: pull request 12, reviewer 8ebabf04-0b08-6a43-9bf4-96e1f4aa3682, vote…

Full schema: https://pipedream.com/apps/azure-devops/actions/add-pull-request-reviewer.md

### `azure_devops-add-work-item-comment` — Add Work Item Comment (Write)

Add a comment to a work item's discussion thread. Returns the new comment's id and rendered text. Use this to post automated status back to the item humans are watching, rather than editing its description. Example: work item 299, comment Deployed to staging in build 4821. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/add-work-item-comment.md

### `azure_devops-cancel-build` — Cancel Build (Write)

Cancel a build that is still running. Returns the build with its status moved to cancelling. Use this to stop a run that has been superseded or was triggered in error. Example: build 4821. Run the List Builds action first to obtain the build id. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/cancel-build.md

### `azure_devops-create-branch` — Create Branch (Write)

Create a branch pointing at an existing commit. Returns the ref update result. Use this to open a working branch before pushing changes and raising a pull request. Example: new branch feature/login at commit a3fecf65a6766ebc6f2e33b66a1520b827c67ef8. Run the List Commits action first to obtain the…

Full schema: https://pipedream.com/apps/azure-devops/actions/create-branch.md

### `azure_devops-create-or-update-file` — Create Or Update File (Write)

Push a single file add, edit or delete to an existing branch, as one commit. Returns the push result including the new commit SHA. The branch must already exist. Use this to commit generated config or docs back to a repository. Example: edit /docs/README.md on main with commit message Update setup…

Full schema: https://pipedream.com/apps/azure-devops/actions/create-or-update-file.md

### `azure_devops-create-or-update-wiki-page` — Create Or Update Wiki Page (Write)

Create a wiki page, or replace the content of an existing one. Returns the resulting page and its version. This replaces the whole page rather than appending, so read the page first if you need to preserve existing content. Use this to publish generated documentation. Example: page path…

Full schema: https://pipedream.com/apps/azure-devops/actions/create-or-update-wiki-page.md

### `azure_devops-create-pipeline` — Create Pipeline (Write)

Create a YAML pipeline from a definition file already committed to a Git repository. Returns the new pipeline's id and name. The YAML file must exist before this call - push it first. Use this to register a new service's CI. Example: name fabrikam-api-CI from /azure-pipelines.yml. See the…

Full schema: https://pipedream.com/apps/azure-devops/actions/create-pipeline.md

### `azure_devops-create-project` — Create Project (Write)

Queue creation of a new project. Project creation is asynchronous, so this returns an operation reference rather than the finished project - poll the project list to see it appear. Use when onboarding a new team or product area. Example: name Payments Platform, visibility private, Agile process…

Full schema: https://pipedream.com/apps/azure-devops/actions/create-project.md

### `azure_devops-create-pull-request` — Create Pull Request (Write)

Open a pull request between two branches. Returns the new pull request's id and url. Use this after pushing a working branch, to start review. Example: source refs/heads/feature/login into target refs/heads/main, title Add SSO login. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/create-pull-request.md

### `azure_devops-create-pull-request-comment` — Create Pull Request Comment (Write)

Start a new comment thread on a pull request, either on the overview or anchored to a line in a file. Returns the new thread with its id. Use this to post automated review findings where the reviewer will see them. Example: pull request 12, file /src/index.js line 42, comment This drops the null…

Full schema: https://pipedream.com/apps/azure-devops/actions/create-pull-request-comment.md

### `azure_devops-create-release` — Create Release (Write)

Create a classic release from a release definition, optionally as a draft or with specific artifact versions. Returns the new release's id and name. Omit Artifacts to take the definition's latest versions. Use this to ship a build through a classic release pipeline. Example: definition 3…

Full schema: https://pipedream.com/apps/azure-devops/actions/create-release.md

### `azure_devops-create-repository` — Create Repository (Write)

Create an empty Git repository in a project. Returns the new repository's id, name and clone urls. The repository starts with no branches - push an initial commit before the other Git actions can act on it. Use when scaffolding a new service. Example: name fabrikam-payments in project…

Full schema: https://pipedream.com/apps/azure-devops/actions/create-repository.md

### `azure_devops-create-wiki` — Create Wiki (Write)

Create a project wiki, or publish a folder of an existing Git repository as a code wiki. Returns the new wiki's id, name and backing repository. A project wiki provisions its own repository; a code wiki needs an existing repository, branch and folder. Use this when standing up documentation for a…

Full schema: https://pipedream.com/apps/azure-devops/actions/create-wiki.md

### `azure_devops-create-work-item` — Create Work Item (Write)

Create a work item of any type - Bug, Task, User Story, Epic. Returns the new work item's id and full field set. Use when turning an alert, form submission or support ticket into tracked work. Example: type Bug, title Checkout returns 500 on empty cart, assigned to jamal@fabrikam.com. See the…

Full schema: https://pipedream.com/apps/azure-devops/actions/create-work-item.md

### `azure_devops-delete-repository` — Delete Repository (Write)

Move a Git repository to the project's recycle bin. Requires the repository's GUID - names are not accepted here. Use this to retire a service's repository; recover it from the project settings recycle bin if this was a mistake. Example: repository 2f3d611a-f012-4b39-b157-8db63f380226. See the…

Full schema: https://pipedream.com/apps/azure-devops/actions/delete-repository.md

### `azure_devops-delete-wiki-page` — Delete Wiki Page (Write)

Delete a wiki page. Returns the deleted page's path and the wiki commit the deletion created. Use this to retire documentation that has moved elsewhere. Example: page path /Guides/Onboarding. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/delete-wiki-page.md

### `azure_devops-delete-work-item` — Delete Work Item (Write)

Move a work item to the project's recycle bin, or permanently destroy it when Destroy is set. Returns the deleted item's id and code. Use this to clean up items created in error - prefer the recycle bin, which is recoverable. Example: work item 299. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/delete-work-item.md

### `azure_devops-get-build` — Get Build (Read-only)

Retrieve one build by id. Returns its status, result, timings, requesting identity and source commit. Use this to poll a build queued earlier until it reaches completed. Example: build 4821. Run the List Builds action first to obtain the build id. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/get-build.md

### `azure_devops-get-build-definition` — Get Build Definition (Read-only)

Retrieve one build definition, including its repository, triggers, variables and process. Use this to inspect what a pipeline will do, or to read its variable names before overriding them at queue time. Example: definition 12. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/get-build-definition.md

### `azure_devops-get-commit` — Get Commit (Read-only)

Retrieve one commit by its full 40-character SHA. Returns its author, committer, message, parents and change counts. Use this to inspect what a specific commit did before referencing it in a branch or release. Example: commit a3fecf65a6766ebc6f2e33b66a1520b827c67ef8. Run the List Commits action…

Full schema: https://pipedream.com/apps/azure-devops/actions/get-commit.md

### `azure_devops-get-file-content` — Get File Content (Read-only)

Read one file from a Git repository, at the default branch or at a specific branch, tag or commit. Returns the file's content along with its object id and path. Use this to read config or documentation without cloning. This is the single-item mode of the items endpoint: it returns one file object…

Full schema: https://pipedream.com/apps/azure-devops/actions/get-file-content.md

### `azure_devops-get-pipeline` — Get Pipeline (Read-only)

Retrieve one pipeline, including the repository and path of the YAML file that defines it. Use this to confirm which definition file a pipeline runs before triggering it. Example: pipeline 12. Run the List Pipelines action first to obtain the pipeline id. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/get-pipeline.md

### `azure_devops-get-pipeline-run` — Get Pipeline Run (Read-only)

Retrieve one pipeline run. Returns its state, result, the resources it consumed and the template parameters it ran with. Use this to poll a run started earlier until its state reaches completed. Example: pipeline 12, run 48. Run the List Pipelines action first to obtain the pipeline id, then the…

Full schema: https://pipedream.com/apps/azure-devops/actions/get-pipeline-run.md

### `azure_devops-get-project` — Get Project (Read-only)

Retrieve one project by id or name. Returns its description, state, visibility, default team and, when Include Capabilities is set, its version-control and process-template settings. Use this to confirm a project exists before writing to it. Example: Fabrikam-Fiber-Git. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/get-project.md

### `azure_devops-get-pull-request` — Get Pull Request (Read-only)

Retrieve one pull request by id. Returns its title, description, status, reviewers, merge status and, optionally, its commits. Use this to check whether a pull request is mergeable before completing it. Example: pull request 12. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/get-pull-request.md

### `azure_devops-get-release` — Get Release (Read-only)

Retrieve one classic release. Returns its environments, each environment's deployment status, and the artifacts it carries. Use this to check whether a release reached production. Example: release 27. Run the List Releases action first to obtain the release id. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/get-release.md

### `azure_devops-get-repository` — Get Repository (Read-only)

Retrieve one Git repository by id or name. Returns its default branch, size, web url and parent project. Use this to confirm a repository's default branch before opening a pull request against it. Example: fabrikam-api. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/get-repository.md

### `azure_devops-get-team` — Get Team (Read-only)

Retrieve one team in a project by id or name. Returns the team's description and identity url. Use this to resolve a team name to its GUID before querying its members. Example: Fabrikam-Fiber-Git Team. Run the List Teams action first to obtain the team id. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/get-team.md

### `azure_devops-get-team-iteration` — Get Team Iteration (Read-only)

Retrieve one of a team's iterations by id. Returns its name, path and the start date, finish date and timeframe recorded against it. Use this to pin down a sprint's window before measuring work item activity against it. Run the List Teams action first for the team, then the List Team Iterations…

Full schema: https://pipedream.com/apps/azure-devops/actions/get-team-iteration.md

### `azure_devops-get-team-settings` — Get Team Settings (Read-only)

Retrieve a team's board and backlog configuration. Returns the days of the week the team works, its backlog iteration, its default iteration, how bugs are surfaced and which backlog levels are visible. Use this to learn a team's working week before turning sprint dates into working days. Run the…

Full schema: https://pipedream.com/apps/azure-devops/actions/get-team-settings.md

### `azure_devops-get-user` — Get User (Read-only)

Retrieve one user by their graph descriptor. Returns their display name, principal name, mail address and origin. Use this to confirm an identity before assigning work to them. Example: descriptor aad.OGViYWJmMDQtMGIwOC03YTQz. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/get-user.md

### `azure_devops-get-velocity` — Get Velocity (Read-only)

Report how much work each iteration actually completed, aggregated from the Analytics service. Returns one row per iteration with its name, start and finish dates and the number of completed work items. Covers the whole project by default; set Team Name to narrow it to a single team, which is what…

Full schema: https://pipedream.com/apps/azure-devops/actions/get-velocity.md

### `azure_devops-get-wiki-page` — Get Wiki Page (Read-only)

Read a wiki page and its Markdown content, optionally including its sub-pages. Returns the page path, content and order. Use this to read runbook or onboarding content into a workflow. Example: page path /Guides/Onboarding. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/get-wiki-page.md

### `azure_devops-get-work-item` — Get Work Item (Read-only)

Retrieve one work item by id. Returns its fields, and optionally its relations and links via Expand. Use this to read the current state of an item before deciding whether to update it. Example: work item 299. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/get-work-item.md

### `azure_devops-list-branches` — List Branches And Tags (Read-only)

List the refs - branches and tags - of a Git repository, each with the commit it points at. Use this to obtain the fully qualified branch names the pull request and build actions expect, and to read a branch's head SHA. Example: filter heads/ returns refs/heads/main at a3fecf65.... See the…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-branches.md

### `azure_devops-list-build-artifacts` — List Build Artifacts (Read-only)

List the artifacts a build published, each with its download url and resource type. Use this to hand a build's output to a downstream deploy step. Example: build 4821 returns drop. Run the List Builds action first to obtain the build id. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/list-build-artifacts.md

### `azure_devops-list-build-definitions` — List Build Definitions (Read-only)

List a project's build definitions. Returns each definition's id, name, repository and queue status. Use this to obtain the definition id the Queue Build action needs. Example: project Fabrikam-Fiber-Git returns fabrikam-api-CI with id 12. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/list-build-definitions.md

### `azure_devops-list-build-logs` — List Build Logs (Read-only)

List a build's log files, each with its id, line count and the url to fetch its content. Use this to locate the log for a failing step before fetching it. Example: build 4821 returns 3 logs. Run the List Builds action first to obtain the build id. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/list-build-logs.md

### `azure_devops-list-builds` — List Builds (Read-only)

List a project's builds, optionally filtered by definition, status, result, branch or time window. Returns each build's id, number, status, result and triggering commit. Use this to report on CI health or to find the last successful build of a branch. Example: result failed on branch…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-builds.md

### `azure_devops-list-classification-nodes` — List Classification Nodes (Read-only)

List a project's area or iteration path tree. Returns the node tree with each node's name and full path. Use this to discover the values the Area Path and Iteration Path inputs of the work item actions expect - those inputs want the backslash-delimited path, not the node name. Example: structure…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-classification-nodes.md

### `azure_devops-list-commits` — List Commits (Read-only)

List a repository's commits, optionally narrowed by author, date range, branch or file path. Returns each commit's SHA, author, message and change counts. Use this to build a changelog or to find the commit that last touched a file. Example: author jamal@fabrikam.com since 2026-01-01T00:00:00Z…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-commits.md

### `azure_devops-list-groups` — List Groups (Read-only)

List the groups in an organization, optionally scoped to one project or collection. Returns each group's display name, descriptor and principal name. Use this to find the group to add as a required pull request reviewer. Example: returns [Fabrikam-Fiber-Git]\\Contributors. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/list-groups.md

### `azure_devops-list-iteration-work-items` — List Iteration Work Items (Read-only)

List the work items assigned to a team's iteration. Returns work item relations carrying each item's id and url rather than its fields, so pass those ids to the List Work Items action to read titles, states and assignees. Use this to take the sprint backlog as it currently stands. Run the List…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-iteration-work-items.md

### `azure_devops-list-organization-name-options` — List Organizations (Read-only)

List the Azure DevOps organizations the connected account belongs to. Use this first - every other action needs an organization name, and this is the only action that does not. Returns the organization names as plain strings. Example: returns contoso and fabrikam. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/list-organization-name-options.md

### `azure_devops-list-pipeline-runs` — List Pipeline Runs (Read-only)

List the most recent runs of a pipeline, each with its id, state, result and creation time. Use this to check whether a pipeline is currently running before triggering another. Example: pipeline 12. Run the List Pipelines action first to obtain the pipeline id. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/list-pipeline-runs.md

### `azure_devops-list-pipelines` — List Pipelines (Read-only)

List a project's YAML pipelines. Returns each pipeline's id, name, folder and revision. Use this to obtain the pipeline id the Run Pipeline action needs. Example: project Fabrikam-Fiber-Git returns fabrikam-api-CI with id 12. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/list-pipelines.md

### `azure_devops-list-processes` — List Processes (Read-only)

List the process templates (Agile, Scrum, Basic, CMMI and any custom ones) available in an organization. Returns each template's id, name and description. Use this to obtain the process template id required by the Create Project action. Example: organization contoso returns Agile with id…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-processes.md

### `azure_devops-list-projects` — List Projects (Read-only)

List the projects in an organization. Returns each project's id, name, state and visibility. Use this first in almost any Azure DevOps workflow - nearly every other action needs a project id or name. Example: organization contoso returns Fabrikam-Fiber-Git alongside its GUID. Returns at most Limit…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-projects.md

### `azure_devops-list-pull-request-threads` — List Pull Request Comment Threads (Read-only)

List the comment threads on a pull request, including threads anchored to a file and line. Returns each thread's comments, author and status. Use this to read review feedback before replying or completing the pull request. Example: pull request 12. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/list-pull-request-threads.md

### `azure_devops-list-pull-requests` — List Pull Requests (Read-only)

List a repository's pull requests, optionally filtered by status, creator, reviewer or branch. Returns each pull request's id, title, status, source and target branches. Use this to find open review work or to check whether a branch already has a pull request. Example: status active targeting…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-pull-requests.md

### `azure_devops-list-release-definitions` — List Release Definitions (Read-only)

List a project's classic release definitions. Returns each definition's id, name and path. Use this to obtain the definition id the Create Release action needs. Classic Release is separate from YAML pipelines. Example: project Fabrikam-Fiber-Git returns fabrikam-api-CD with id 3. See the…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-release-definitions.md

### `azure_devops-list-releases` — List Releases (Read-only)

List a project's classic releases, optionally filtered by definition or status. Returns each release's id, name, status and the definition it came from. Use this to report on what has shipped. Example: definition 3, status active. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/list-releases.md

### `azure_devops-list-repositories` — List Repositories (Read-only)

List the Git repositories in a project, or across the whole organization when no project is given. Returns each repository's id, name, default branch and size. Use this to obtain the repository id or name every other Git action needs. Example: project Fabrikam-Fiber-Git returns fabrikam-api and its…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-repositories.md

### `azure_devops-list-repository-items` — List Repository Items (Read-only)

List the files and folders under a path in a Git repository. Returns each entry's path, object id and whether it is a folder. Use this to explore a repository's layout, then read a specific file with the Get File Content action. Azure DevOps rejects a recursion level other than none when a single…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-repository-items.md

### `azure_devops-list-service-endpoints` — List Service Endpoints (Read-only)

List a project's service connections, optionally filtered by type. Returns each connection's id, name, type and authorization scheme, without its secrets. Use this to audit which external systems a project can reach from its pipelines. Example: type github returns the GitHub connection and its id…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-service-endpoints.md

### `azure_devops-list-team-capacity` — List Team Capacity (Read-only)

Retrieve every team member's capacity for an iteration, with their per-day hours split across activities and their individual days off. Returns the per-member records and the team totals. Use this against the iteration's work item list to judge whether a sprint is overcommitted. Run the List Teams…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-team-capacity.md

### `azure_devops-list-team-days-off` — List Team Days Off (Read-only)

List the days the whole team is off during an iteration, such as public holidays or a team offsite. Returns each range's start and end date. Use this to subtract non-working days before reading capacity as available hours. Run the List Teams action first for the team, then the List Team Iterations…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-team-days-off.md

### `azure_devops-list-team-iterations` — List Team Iterations (Read-only)

List the iterations a team is subscribed to, each with its name, path and the start date, finish date and timeframe held in its attributes. Set Timeframe to current to resolve the sprint that is running right now. Use this as the entry point for any sprint question, then pass the iteration id it…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-team-iterations.md

### `azure_devops-list-team-members` — List Team Members (Read-only)

List the members of a team. Returns each member's display name, unique name, identity id and whether they are a team admin. Use this to find the identity GUID that the pull request reviewer actions require. Example: team Fabrikam-Fiber-Git Team returns Jamal Hartnett and his identity id. Returns at…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-team-members.md

### `azure_devops-list-teams` — List Teams (Read-only)

List the teams in a project. Returns each team's id, name and description. Use this to obtain the team id or name the other team actions need, or to fan a notification out per team. Example: project Fabrikam-Fiber-Git returns Fabrikam-Fiber-Git Team. Returns at most Limit results per call - if that…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-teams.md

### `azure_devops-list-users` — List Users (Read-only)

List the users in an organization, optionally narrowed by subject type. Returns each user's display name, principal name, descriptor and origin id. Use this to resolve a person to the identity GUID that the pull request reviewer and creator inputs require. Example: subject type aad returns Jamal…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-users.md

### `azure_devops-list-wikis` — List Wikis (Read-only)

List the wikis in a project, or across the organization when no project is given. Returns each wiki's id, name, type and backing repository. Use this to obtain the wiki id or name the wiki page actions need. Example: project Fabrikam-Fiber-Git returns Fabrikam-Fiber-Git.wiki. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/list-wikis.md

### `azure_devops-list-work-item-comments` — List Work Item Comments (Read-only)

List the comments on a work item, newest first. Returns each comment's text, author and creation date. Use this to read the human discussion around an item before acting on it. Example: work item 299. Returns the newest Limit comments, up to the API maximum of 200; the response's continuationToken…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-work-item-comments.md

### `azure_devops-list-work-item-fields` — List Work Item Fields (Read-only)

List the work item fields defined in an organization or project, with each field's reference name and data type. Use this to discover the reference names the Additional Fields and Fields inputs of the other work item actions expect. Example: returns Microsoft.VSTS.Common.Priority for the field…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-work-item-fields.md

### `azure_devops-list-work-item-revisions` — List Work Item Revisions (Read-only)

List the revision history of a work item, one entry per change. Returns each revision's field values at that point in time. Use this to answer who changed what and when, or to reconstruct how long an item sat in a state. Example: work item 299. Returns at most Limit results per call - if that many…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-work-item-revisions.md

### `azure_devops-list-work-item-types` — List Work Item Types (Read-only)

List the work item types available in a project, each with the states and fields it allows. Use this to discover valid values for the Work Item Type and State inputs before creating or updating an item - the states differ per process, so a Basic project uses To Do/Doing/Done where Agile uses…

Full schema: https://pipedream.com/apps/azure-devops/actions/list-work-item-types.md

### `azure_devops-list-work-items` — List Work Items (Read-only)

Retrieve a batch of work items by id in one call, up to 200 at a time. Returns each item's fields. Use this after a query to turn a list of ids into the actual field values. Example: ids 297,298,299. See the documentation

Full schema: https://pipedream.com/apps/azure-devops/actions/list-work-items.md

### `azure_devops-query-analytics` — Query Analytics (OData) (Read-only)

Run an OData query against the Azure DevOps Analytics service, which holds the historical and aggregated data the work item APIs do not expose. Returns the matching rows plus the @odata.context describing them. Use this for trend questions - how many bugs were open each day, how much work each…

Full schema: https://pipedream.com/apps/azure-devops/actions/query-analytics.md

### `azure_devops-query-work-items` — Query Work Items (WIQL) (Read-only)

Run a Work Item Query Language (WIQL) query and return the matching work item references. Returns ids and the queried columns, not full field values - pass the ids to the List Work Items action to read those. Use this whenever you need to find work by state, type, assignee or date. Example: SELECT…

Full schema: https://pipedream.com/apps/azure-devops/actions/query-work-items.md

### `azure_devops-queue-build` — Queue Build (Write)

Queue a new build for a build definition, optionally on a specific branch and with variable overrides. Returns the queued build's id and status - the build itself runs asynchronously. Use this to trigger CI from an external event. Example: definition 12 on refs/heads/main with parameters {…

Full schema: https://pipedream.com/apps/azure-devops/actions/queue-build.md

### `azure_devops-run-pipeline` — Run Pipeline (Write)

Trigger a run of a YAML pipeline, optionally on a specific branch and with template parameters or variable overrides. Returns the run's id and state; the run itself proceeds asynchronously. Set Preview Run to validate instead: Azure DevOps then starts nothing and returns the final expanded YAML…

Full schema: https://pipedream.com/apps/azure-devops/actions/run-pipeline.md

### `azure_devops-update-pull-request` — Update Pull Request (Write)

Update a pull request - retitle it, edit its description, retarget it, publish a draft, or complete or abandon it. At least one field is required. Returns the updated pull request. Use status completed to merge and abandoned to close without merging. Example: pull request 12, status abandoned. See…

Full schema: https://pipedream.com/apps/azure-devops/actions/update-pull-request.md

### `azure_devops-update-work-item` — Update Work Item (Write)

Update an existing work item - retitle it, move it between states, reassign it, repoint its area and iteration, or link it to another work item. At least one field or a link is required. Returns the updated work item. Use when closing out automated work or reflecting a change from another system…

Full schema: https://pipedream.com/apps/azure-devops/actions/update-work-item.md

## Triggers (1)

### `azure_devops-new-event` — New Event (Instant) (Instant)

Emit new event for the specified event type.

Full schema: https://pipedream.com/apps/azure-devops/triggers/new-event.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt
