View as Markdown
Azure DevOps icon

Azure DevOps ACTION

List Builds

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 refs/heads/main. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Azure DevOps account once, then configure and run List Builds from your backend or agent.

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-list-builds",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    azure_devops: { authProvisionId: "apn_xxxxxxx" },
    organization: "Organization",
    project: "Project",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

List Builds inputs
Property Type Description
organization Organization string
Name of the organization
Required Dynamic
project Project string
Project ID or project name. Run the List Projects action first to obtain valid values.
Required
definitionIds Build Definition IDs string[]
Only return builds for these definition IDs. Run the List Build Definitions action first to obtain valid values.
Optional
statusFilter Status string
Only return builds in this status
Optional
resultFilter Result string
Only return builds with this result
Optional
branchName Branch string
Only return builds that ran on this fully qualified branch name, e.g. refs/heads/main
Optional
queryOrder Query Order string
Order the results are returned in
Optional
minTime Min Time string
Only return builds after this date, e.g. 2026-01-01T00:00:00Z. Interpreted against the field named by Query Order.
Optional
maxTime Max Time string
Only return builds before this date, e.g. 2026-01-31T00:00:00Z. Interpreted against the field named by Query Order.
Optional
limit Limit integer
Maximum number of builds to return (1-1000)
Optional
buildIds Build IDs string[]
Only return these build IDs, e.g. ["4821", "4822"]. Run the List Builds action first to obtain valid values.
Optional
buildNumber Build Number string
Only return builds matching this build number. Append * for a prefix search, e.g. 20260820.*
Optional
reasonFilter Reason string
Only return builds started for this reason
Optional
requestedFor Requested For string
Only return builds requested by this identity GUID, e.g. d6245f20-2af8-44f4-9451-8107cb2767db. Run the List Users action first to obtain valid values.
Optional
repositoryId Repository string
Only return builds from this repository. Requires Repository Type. Run the List Repositories action first to obtain valid values.
Optional
repositoryType Repository Type string
Type of the repository named in Repository, e.g. TfsGit, GitHub
Optional
tagFilters Tags string[]
Only return builds carrying all of these tags
Optional
properties Properties string[]
Extended property names to return with each build
Optional
queues Queue IDs string[]
Only return builds that ran on these agent queue IDs, e.g. ["9"]. Queue IDs appear as queue.id on any build this action returns.
Optional
maxBuildsPerDefinition Max Builds Per Definition integer
Cap how many builds are returned for each definition
Optional
deletedFilter Deleted Filter string
Whether to exclude, include or only return deleted builds. Defaults to excludeDeleted.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
azure_devops-list-builds
Version
0.0.2
App
Azure DevOps
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes