Azure DevOps - Nango Docs

Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

Pre-built tooling

✅ Authorization

Tools	Status
Pre-built authorization (Basic)	✅
Pre-built authorization UI	✅
Custom authorization UI	✅
End-user authorization guide	✅
Expired credentials detection	✅

✅ Read & write data

Tools	Status
Pre-built integrations	✅
API unification	✅
2-way sync	✅
Webhooks from Nango on data modifications	✅
Real-time webhooks from 3rd-party API	🚫 (time to contribute: <48h)
Proxy requests	✅

✅ Observability & data quality

Tools	Status
HTTP request logging	✅
End-to-end type safety	✅
Data runtime validation	✅
OpenTelemetry export	✅
Slack alerts on errors	✅
Integration status API	✅

✅ Customization

Tools	Status
Create or customize use-cases	✅
Pre-configured pagination	🚫 (time to contribute: <48h)
Pre-configured rate-limit handling	🚫 (time to contribute: <48h)
Per-customer configurations	✅

Others

Function name	Description	Type
`create-pr-thread`	Add a comment thread to a pull request.	Tool
`create-pull-request`	Create a pull request.	Tool
`create-work-item`	Create a work item of a given type using JSON Patch.	Tool
`delete-work-item`	Delete a work item by ID (moves to recycle bin).	Tool
`get-project`	Retrieve a single Azure DevOps project by ID or name.	Tool
`get-repository`	Retrieve a single Git repository by ID or name.	Tool
`get-work-item`	Retrieve a work item by ID.	Tool
`list-boards`	List Kanban boards for a team.	Tool
`list-branches`	List Git branches (refs/heads) in a repository	Tool
`list-build-definitions`	List build pipeline definitions in a project.	Tool
`list-builds`	List builds in a project.	Tool
`list-commits`	List commits in a Git repository with optional date/branch filters.	Tool
`list-iterations`	List sprint iterations for a team.	Tool
`list-pipeline-runs`	List runs for a specific YAML pipeline.	Tool
`list-pipelines`	List YAML pipeline definitions in a project.	Tool
`list-pr-threads`	List comment threads on a pull request.	Tool
`list-projects`	List Azure DevOps projects in the organization.	Tool
`list-pull-requests`	List pull requests in a repository with searchCriteria filters.	Tool
`list-repositories`	List Git repositories in a project.	Tool
`list-team-members`	List members of a team.	Tool
`list-teams`	List teams within a project.	Tool
`list-test-plans`	List test plans in a project.	Tool
`list-wikis`	List wikis in a project.	Tool
`push-commits`	Push one or more file changes to a Git repository branch.	Tool
`query-work-items`	Run a WIQL query to get matching work item IDs, then hydrate fields in batches.	Tool
`queue-build`	Queue a classic build.	Tool
`run-pipeline`	Trigger a YAML pipeline run.	Tool
`update-pull-request`	Update a pull request (title, description, status, reviewers, etc.).	Tool
`update-work-item`	Update a work item using JSON Patch	Tool
`branches`	Sync Git branches (refs/heads) across repositories	Sync
`build-definitions`	Sync classic pipeline (build) definitions.	Sync
`builds`	Sync builds with incremental time-based filtering.	Sync
`commits`	Sync Git commits across repositories with incremental date filtering.	Sync
`iterations`	Sync sprint iterations for all teams	Sync
`pipelines`	Sync YAML pipeline definitions	Sync
`projects`	Sync all projects in the organization	Sync
`pull-requests`	Sync pull requests across repositories with incremental status and date filtering	Sync
`repositories`	Sync Git repositories across all projects	Sync
`teams`	Sync teams across all projects	Sync
`test-plans`	Sync test plans across projects	Sync
`work-items`	Sync work items using WIQL ChangedDate filter, then hydrate fields in batches	Sync

Access requirements

Pre-Requisites	Status	Comment
Paid dev account	✅	Free tier available but with limitations
Paid test account	✅	Free tier available but with limitations
Partnership	❌	Not required
App review	❌	Not required
Security audit	❌	Not required

Setup guide

See the connection guide to get started.

Need help getting started? Get help in the community.

Contribute improvements to the setup guide by editing this page

Useful links

Contribute useful links by editing this page

API gotchas

Personal Access Tokens (PATs) have a maximum lifetime of 1 year
Rate limiting is applied based on multiple factors including type of request and load on the service
Some APIs require specific scopes in the PAT to access
Organization-level APIs require organization-level PATs

Contribute API gotchas by editing this page