View as Markdown
Azure DevOps icon

Azure DevOps ACTION

List Commits

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. Returns at most Limit results per call - if that many come back there may be more, so raise Skip by Limit and call again to page through the rest. 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 Commits 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-commits",
  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 Commits 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
repositoryId Repository string
Repository ID or repository name. Run the List Repositories action first to obtain valid values.
Required
version Version string
Branch, tag or commit to list history from. Defaults to the repository's default branch.
Optional
versionType Version Type string
How Version is interpreted. Defaults to branch.
Optional
author Author string
Alias or display name of the commit author to filter by
Optional
itemPath Item Path string
Return only commits that touched this repository-relative path, e.g. /src/index.js
Optional
fromDate From Date string
Return commits made on or after this date, e.g. 2026-01-01T00:00:00Z
Optional
toDate To Date string
Return commits made on or before this date, e.g. 2026-01-31T00:00:00Z
Optional
limit Limit integer
Maximum number of commits to return (1-1000)
Optional
skip Skip integer
Number of results to skip before returning matches. Use with Limit to page through results.
Optional
versionOptions Version Options string
Modifier applied to Version, e.g. previousChange to start from the commit before it
Optional
compareVersion Compare Version string
Return only commits between Version and this branch, tag or commit
Optional
compareVersionType Compare Version Type string
How to interpret Compare Version. Defaults to branch.
Optional
compareVersionOptions Compare Version Options string
Modifier applied to Compare Version
Optional
ids Commit IDs string[]
Only return these commit SHAs, e.g. a3fecf65a6766ebc6f2e33b66a1520b827c67ef8. Azure DevOps treats this as an exclusive lookup: it cannot be combined with any other filter, though Limit, Skip and the include options still apply.
Optional
user User string
Alias or display name of the committer to filter by. Author filters on who wrote the change instead.
Optional
fromCommitId From Commit ID string
Walk history starting at this commit SHA, e.g. a3fecf65a6766ebc6f2e33b66a1520b827c67ef8. Run the List Commits action without a range first to obtain valid SHAs.
Optional
toCommitId To Commit ID string
Walk history up to this commit SHA, e.g. a3fecf65a6766ebc6f2e33b66a1520b827c67ef8. Run the List Commits action without a range first to obtain valid SHAs.
Optional
historyMode History Mode string
How merge commits are walked when Item Path is set. Defaults to simplifiedHistory.
Optional
excludeDeletes Exclude Deletes boolean
Exclude commits whose only change to Item Path was deleting it
Optional
showOldestCommitsFirst Show Oldest Commits First boolean
Return the oldest commits first instead of the newest
Optional
includeWorkItems Include Work Items boolean
Include the work items associated with each commit. Use this to tie delivered code back to the stories it closed.
Optional
includePushData Include Push Data boolean
Include the push each commit arrived in
Optional
includeUserImageUrl Include User Image URL boolean
Include avatar urls for the author and committer
Optional
includeLinks Include Links boolean
Include reference links for each commit
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-commits
Version
0.0.2
App
Azure DevOps
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes