Azure DevOps

Learn the basic patterns for using the REST APIs for Azure DevOps Services and Azure DevOps Server.

Azure DevOps publishes 5 APIs on the APIs.io network, including Fields API, Pipelines API, Queries API, and 2 more. Tagged areas include Azure, CI/CD, DevOps, Pipelines, and Work Items.

The Azure DevOps catalog on APIs.io includes 1 event-driven AsyncAPI specification, 3 JSON-LD contexts, and 3 Spectral governance rulesets.

Azure DevOps’ developer surface includes authentication, documentation, developer portal, API reference, getting-started guide, changelog, CLI, and 38 more developer resources.

🌐 Visit website 📡 Source on GitHub

63.2/100 strong ▬ flat Agent 53/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessPaidSelf serveFree trial⚡ Free to try

9 APIs 1 MCP Servers 6 Features 3 Use Cases

AzureCI/CDDevOpsPipelinesWork Items

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 63.2/100 · strong

Contract Quality 19.2 / 25

Developer Ergonomics 16.5 / 20

Commercial Clarity 7.9 / 20

Operational Transparency 6.8 / 13

Governance 6.3 / 12

Discoverability 6.5 / 10

Agent readiness — 53/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 6 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/azure-devops: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 9

Individual APIs this provider publishes, each with its own machine-readable definition.

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Rate Limits 1

Documented rate limits and quota policies.

Azure Devops Rate Limits

4 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Azure Devops Finops

FINOPS

Features 6

Notable capabilities this provider offers.

Work Item Tracking

Create, update, query, and manage work items across Azure Boards

CI/CD Pipelines

Build, test, and deploy with YAML-based and classic pipelines

Git Repositories

Host and manage Git repositories with branch policies and pull requests

Artifacts

Package management for NuGet, npm, Maven, Python, and Universal Packages

Test Plans

Comprehensive test management with automated and manual testing

Release Management

Multi-stage deployment pipelines with approval workflows

JSON Schema 12

Standalone JSON Schema definitions for this provider's data models.

Scroll for all 12

JSON Structure 11

JSON Structure definitions describing this provider's data shapes.

Scroll for all 11

Examples 11

Example request and response payloads for these APIs.

Scroll for all 11

Scopes 1

OAuth scopes governing access to this provider's APIs.

Azure Devops Scopes

4 scopes · authorizationCode

4 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Azure Devops Agentic Access

12 operations · 5 acting

AGENTIC

Use Cases 3

What developers build with this provider.

Agile Project Management

Track work items, sprints, and backlogs for Agile development teams

CI/CD Automation

Automate build, test, and deployment workflows across environments

Code Review

Enforce branch policies and manage pull request workflows

Integrations 3

Pre-built integrations with other platforms and tools.

GitHub

Import repositories and trigger pipelines from GitHub events

Slack

Notifications for pipeline runs and work item updates

Jira

Bidirectional sync of work items with Jira issues

Resources

Get Started 2

Portal, sign-up, and the first successful call

Portal

Portal

GettingStarted

GettingStarted

Documentation 17

Reference material describing how the API behaves

Documentation

APIReference

Documentation

OpenAPI

OpenAPI

Create Pipeline Request Schema

JSONSchema

Pipelines Error Schema

JSONSchema

Pipeline Run Schema

JSONSchema

Pipeline Schema

JSONSchema

Run Pipeline Request Schema

JSONSchema

Work Items Error Schema

JSONSchema

JSON Patch Operation Schema

JSONSchema

WIQL Result Schema

JSONSchema

Work Item Field Schema

JSONSchema

Work Item Relation Schema

JSONSchema

Work Item Schema

JSONSchema

Work Item Schema (Legacy)

JSONSchema

Scroll for all 17

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

MCPServer

MCPServer

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Azure DevOps JSON-LD Context

JSONLD

Pipelines JSON-LD Context

JSONLD

Work Items JSON-LD Context

JSONLD

Azure DevOps Vocabulary

Vocabulary

Spectral Rules

Rules

Build 7

SDKs, sample code, and the tooling you integrate with

PostmanWorkspace

PostmanWorkspace

GitHubOrganization

Node.js SDK

Python SDK

Go SDK

Java SDK

Azure DevOps CLI Extension

CLI

Scroll for all 7

Access & Security 5

Authentication, authorization, and security posture

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

Authentication

OAuthScopes

Authentication

Operate 2

Status, limits, changes, and where to get help

RateLimits

RateLimits

ChangeLog

ChangeLog

Company 2

The organization behind the API

LinkedIn

Blog

Blog

Other 3

Properties that don't map to a standard resource type

DevOps Project Management Workflow

Capabilities

Work Items Shared Capability

Capabilities

Pipelines Shared Capability

Capabilities

Source (apis.yml)

aid: azure-devops
name: Azure DevOps
description: Learn the basic patterns for using the REST APIs for Azure DevOps Services and Azure DevOps Server.
url: https://raw.githubusercontent.com/api-evangelist/azure-devops/refs/heads/main/apis.yml
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: true
  try_now: true
  public: false
  label: Paid (free trial) · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://raw.githubusercontent.com/api-evangelist/azure-devops/refs/heads/main/image.png
tags:
- Azure
- CI/CD
- DevOps
- Pipelines
- Work Items
created: '2024-01-01'
modified: '2026-05-19'
specificationVersion: '0.19'
type: Index
apis:
- aid: azure-devops:azure-devops-git-api
  name: Azure DevOps Git Repositories API
  tags:
  - Azure
  - CI/CD
  - DevOps
  - Git
  - Pull Requests
  - Version Control
  image: https://raw.githubusercontent.com/api-evangelist/azure-devops/refs/heads/main/image.png
  humanURL: https://learn.microsoft.com/en-us/rest/api/azure/devops/
  baseURL: https://dev.azure.com/{organization}
  properties:
  - url: https://learn.microsoft.com/en-us/rest/api/azure/devops/git/?view=azure-devops-rest-7.2
    type: APIReference
  - url: https://learn.microsoft.com/en-us/azure/devops/integrate/how-to/call-rest-api?view=azure-devops
    type: GettingStarted
  - url: https://learn.microsoft.com/en-us/azure/devops/integrate/get-started/authentication/authentication-guidance?view=azure-devops
    type: Authentication
  description: The Azure DevOps Git Repositories API provides REST endpoints for managing Git repositories, branches, commits,
    pull requests, and code reviews. APIs enable automation of repository management, pull request workflows, branch policies,
    and code review processes within Azure Repos.
- aid: azure-devops:azure-devops-artifacts-api
  name: Azure DevOps Artifacts API
  tags:
  - Artifacts
  - Azure
  - CI/CD
  - DevOps
  - Npm
  - NuGet
  - Package Management
  image: https://raw.githubusercontent.com/api-evangelist/azure-devops/refs/heads/main/image.png
  humanURL: https://learn.microsoft.com/en-us/rest/api/azure/devops/
  baseURL: https://pkgs.dev.azure.com/{organization}
  properties:
  - url: https://learn.microsoft.com/en-us/rest/api/azure/devops/artifacts/?view=azure-devops-rest-7.2
    type: APIReference
  - url: https://learn.microsoft.com/en-us/azure/devops/integrate/how-to/call-rest-api?view=azure-devops
    type: GettingStarted
  description: The Azure DevOps Artifacts API provides REST endpoints for managing package feeds including NuGet, npm, Maven,
    Python, and Universal Packages. APIs support feed creation, package publishing, version management, and upstream source
    configuration for artifact management in DevOps workflows.
- aid: azure-devops:azure-devops-test-plans-api
  name: Azure DevOps Test Plans API
  tags:
  - Azure
  - CI/CD
  - DevOps
  - Test Plans
  - Testing
  image: https://raw.githubusercontent.com/api-evangelist/azure-devops/refs/heads/main/image.png
  humanURL: https://learn.microsoft.com/en-us/rest/api/azure/devops/
  baseURL: https://dev.azure.com/{organization}
  properties:
  - url: https://learn.microsoft.com/en-us/rest/api/azure/devops/testplan/?view=azure-devops-rest-7.2
    type: APIReference
  - url: https://learn.microsoft.com/en-us/azure/devops/integrate/how-to/call-rest-api?view=azure-devops
    type: GettingStarted
  description: The Azure DevOps Test Plans API provides REST endpoints for managing test plans, test suites, test cases, and
    test runs. APIs support automated test management, test result reporting, and integration with CI/CD pipelines for comprehensive
    quality assurance workflows.
- aid: azure-devops:azure-devops-release-api
  name: Azure DevOps Release API
  tags:
  - Azure
  - CI/CD
  - Deployment
  - DevOps
  - Release Management
  image: https://raw.githubusercontent.com/api-evangelist/azure-devops/refs/heads/main/image.png
  humanURL: https://learn.microsoft.com/en-us/rest/api/azure/devops/
  baseURL: https://vsrm.dev.azure.com/{organization}
  properties:
  - url: https://learn.microsoft.com/en-us/rest/api/azure/devops/release/?view=azure-devops-rest-7.1
    type: APIReference
  - url: https://learn.microsoft.com/en-us/azure/devops/integrate/how-to/call-rest-api?view=azure-devops
    type: GettingStarted
  description: The Azure DevOps Release API provides REST endpoints for managing release pipelines, deployments, and environments.
    APIs support release definition management, deployment approvals, environment configuration, and release history tracking
    for continuous delivery workflows.
- aid: azure-devops:azure-devops-fields-api
  name: Azure DevOps Fields API
  description: Work item field definitions
  humanURL: https://learn.microsoft.com/en-us/rest/api/azure/devops/
  baseURL: https://dev.azure.com/{organization}
  tags:
  - Fields
  properties:
  - type: OpenAPI
    url: openapi/azure-devops-fields-api-openapi.yml
  - type: APIReference
    url: https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/?view=azure-devops-rest-7.2
  - type: GettingStarted
    url: https://learn.microsoft.com/en-us/azure/devops/integrate/how-to/call-rest-api?view=azure-devops
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/devops/integrate/get-started/authentication/authentication-guidance?view=azure-devops
  - type: APIReference
    url: https://learn.microsoft.com/en-us/rest/api/azure/devops/pipelines/?view=azure-devops-rest-7.2
- aid: azure-devops:azure-devops-pipelines-api
  name: Azure DevOps Pipelines API
  description: Pipeline definition management
  humanURL: https://learn.microsoft.com/en-us/rest/api/azure/devops/
  baseURL: https://dev.azure.com/{organization}
  tags:
  - Pipelines
  properties:
  - type: OpenAPI
    url: openapi/azure-devops-pipelines-api-openapi.yml
  - type: APIReference
    url: https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/?view=azure-devops-rest-7.2
  - type: GettingStarted
    url: https://learn.microsoft.com/en-us/azure/devops/integrate/how-to/call-rest-api?view=azure-devops
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/devops/integrate/get-started/authentication/authentication-guidance?view=azure-devops
  - type: APIReference
    url: https://learn.microsoft.com/en-us/rest/api/azure/devops/pipelines/?view=azure-devops-rest-7.2
- aid: azure-devops:azure-devops-queries-api
  name: Azure DevOps Queries API
  description: Work item query execution
  humanURL: https://learn.microsoft.com/en-us/rest/api/azure/devops/
  baseURL: https://dev.azure.com/{organization}
  tags:
  - Queries
  properties:
  - type: OpenAPI
    url: openapi/azure-devops-queries-api-openapi.yml
  - type: APIReference
    url: https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/?view=azure-devops-rest-7.2
  - type: GettingStarted
    url: https://learn.microsoft.com/en-us/azure/devops/integrate/how-to/call-rest-api?view=azure-devops
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/devops/integrate/get-started/authentication/authentication-guidance?view=azure-devops
  - type: APIReference
    url: https://learn.microsoft.com/en-us/rest/api/azure/devops/pipelines/?view=azure-devops-rest-7.2
- aid: azure-devops:azure-devops-runs-api
  name: Azure DevOps Runs API
  description: Pipeline run execution and monitoring
  humanURL: https://learn.microsoft.com/en-us/rest/api/azure/devops/
  baseURL: https://dev.azure.com/{organization}
  tags:
  - Runs
  properties:
  - type: OpenAPI
    url: openapi/azure-devops-runs-api-openapi.yml
  - type: APIReference
    url: https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/?view=azure-devops-rest-7.2
  - type: GettingStarted
    url: https://learn.microsoft.com/en-us/azure/devops/integrate/how-to/call-rest-api?view=azure-devops
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/devops/integrate/get-started/authentication/authentication-guidance?view=azure-devops
  - type: APIReference
    url: https://learn.microsoft.com/en-us/rest/api/azure/devops/pipelines/?view=azure-devops-rest-7.2
- aid: azure-devops:azure-devops-workitems-api
  name: Azure DevOps WorkItems API
  description: Work item CRUD and management
  humanURL: https://learn.microsoft.com/en-us/rest/api/azure/devops/
  baseURL: https://dev.azure.com/{organization}
  tags:
  - WorkItems
  properties:
  - type: OpenAPI
    url: openapi/azure-devops-workitems-api-openapi.yml
  - type: APIReference
    url: https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/?view=azure-devops-rest-7.2
  - type: GettingStarted
    url: https://learn.microsoft.com/en-us/azure/devops/integrate/how-to/call-rest-api?view=azure-devops
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/devops/integrate/get-started/authentication/authentication-guidance?view=azure-devops
  - type: APIReference
    url: https://learn.microsoft.com/en-us/rest/api/azure/devops/pipelines/?view=azure-devops-rest-7.2
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/azure-devops/overview
- type: AgenticAccess
  url: agentic-access/azure-devops-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/azure-devops-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/azure-devops-domain-security.yml
- type: Authentication
  url: authentication/azure-devops-authentication.yml
- type: OAuthScopes
  url: scopes/azure-devops-scopes.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/microsoft-azure-devops
- url: https://azure.microsoft.com/en-us/products/devops
  type: Documentation
- url: https://learn.microsoft.com/en-us/rest/api/azure/devops/
  type: Portal
- url: https://learn.microsoft.com/en-us/rest/api/azure/devops/?view=azure-devops-rest-7.2
  type: APIReference
- url: https://learn.microsoft.com/en-us/azure/devops/integrate/how-to/call-rest-api?view=azure-devops
  type: GettingStarted
- url: https://learn.microsoft.com/en-us/azure/devops/integrate/get-started/authentication/authentication-guidance?view=azure-devops
  type: Authentication
- url: https://learn.microsoft.com/en-us/azure/devops/integrate/concepts/rate-limits?view=azure-devops
  type: RateLimits
- url: https://learn.microsoft.com/en-us/azure/devops/release-notes/features-timeline-released
  type: ChangeLog
- url: https://learn.microsoft.com/en-us/azure/devops/dev-resources/?view=azure-devops
  type: Documentation
- type: Features
  data:
  - name: Work Item Tracking
    description: Create, update, query, and manage work items across Azure Boards
  - name: CI/CD Pipelines
    description: Build, test, and deploy with YAML-based and classic pipelines
  - name: Git Repositories
    description: Host and manage Git repositories with branch policies and pull requests
  - name: Artifacts
    description: Package management for NuGet, npm, Maven, Python, and Universal Packages
  - name: Test Plans
    description: Comprehensive test management with automated and manual testing
  - name: Release Management
    description: Multi-stage deployment pipelines with approval workflows
- type: UseCases
  data:
  - name: Agile Project Management
    description: Track work items, sprints, and backlogs for Agile development teams
  - name: CI/CD Automation
    description: Automate build, test, and deployment workflows across environments
  - name: Code Review
    description: Enforce branch policies and manage pull request workflows
- type: Integrations
  data:
  - name: GitHub
    description: Import repositories and trigger pipelines from GitHub events
  - name: Slack
    description: Notifications for pipeline runs and work item updates
  - name: Jira
    description: Bidirectional sync of work items with Jira issues
- type: GitHubOrganization
  url: https://github.com/microsoft
- type: SDKs
  url: https://github.com/microsoft/azure-devops-node-api
  title: Node.js SDK
- type: SDKs
  url: https://github.com/microsoft/azure-devops-python-api
  title: Python SDK
- type: SDKs
  url: https://github.com/microsoft/azure-devops-go-api
  title: Go SDK
- type: SDKs
  url: https://github.com/microsoft/azure-devops-java-api
  title: Java SDK
- type: CLI
  url: https://github.com/Azure/azure-devops-cli-extension
  title: Azure DevOps CLI Extension
- type: OpenAPI
  url: openapi/azure-devops-work-items-openapi.yml
- type: OpenAPI
  url: openapi/azure-devops-pipelines-openapi.yml
- type: JSONSchema
  url: json-schema/azure-devops-pipelines-create-pipeline-request-schema.json
  title: Create Pipeline Request Schema
- type: JSONSchema
  url: json-schema/azure-devops-pipelines-error-schema.json
  title: Pipelines Error Schema
- type: JSONSchema
  url: json-schema/azure-devops-pipelines-pipeline-run-schema.json
  title: Pipeline Run Schema
- type: JSONSchema
  url: json-schema/azure-devops-pipelines-pipeline-schema.json
  title: Pipeline Schema
- type: JSONSchema
  url: json-schema/azure-devops-pipelines-run-pipeline-request-schema.json
  title: Run Pipeline Request Schema
- type: JSONSchema
  url: json-schema/azure-devops-work-items-error-schema.json
  title: Work Items Error Schema
- type: JSONSchema
  url: json-schema/azure-devops-work-items-json-patch-operation-schema.json
  title: JSON Patch Operation Schema
- type: JSONSchema
  url: json-schema/azure-devops-work-items-wiql-result-schema.json
  title: WIQL Result Schema
- type: JSONSchema
  url: json-schema/azure-devops-work-items-work-item-field-schema.json
  title: Work Item Field Schema
- type: JSONSchema
  url: json-schema/azure-devops-work-items-work-item-relation-schema.json
  title: Work Item Relation Schema
- type: JSONSchema
  url: json-schema/azure-devops-work-items-work-item-schema.json
  title: Work Item Schema
- type: JSONSchema
  url: json-schema/azure-devops-workitem-schema.json
  title: Work Item Schema (Legacy)
- type: JSONLD
  url: json-ld/azure-devops-context.jsonld
  title: Azure DevOps JSON-LD Context
- type: JSONLD
  url: json-ld/azure-devops-pipelines-context.jsonld
  title: Pipelines JSON-LD Context
- type: JSONLD
  url: json-ld/azure-devops-work-items-context.jsonld
  title: Work Items JSON-LD Context
- type: Vocabulary
  url: vocabulary/azure-devops-vocabulary.yaml
  title: Azure DevOps Vocabulary
- type: Rules
  url: rules/azure-devops-spectral-rules.yml
  title: Spectral Rules
- type: Capabilities
  url: capabilities/devops-project-management.yaml
  title: DevOps Project Management Workflow
- type: Capabilities
  url: capabilities/shared/work-items.yaml
  title: Work Items Shared Capability
- type: Capabilities
  url: capabilities/shared/pipelines.yaml
  title: Pipelines Shared Capability
- name: MCP Server
  url: https://github.com/microsoft/azure-devops-mcp
  type: MCPServer
- url: https://devblogs.microsoft.com/devops/feed/
  type: Blog
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com

Azure DevOps

APIs 9

Postman Collections 5

Open Collections 2

MCP Servers 1

Pricing Plans 1

Rate Limits 1

FinOps 1

Features 6

Work Item Tracking

CI/CD Pipelines

Git Repositories

Artifacts

Test Plans

Release Management

Event Specifications 1

Semantic Vocabularies 3

Spectral Rules 3

JSON Schema 12

JSON Structure 11

Examples 11

Security Posture 3

Scopes 1

Agentic Access 1

Use Cases 3

Agile Project Management

CI/CD Automation

Code Review

Integrations 3

GitHub

Slack

Jira

Get Started 2

Documentation 17

Agent Surfaces 2

Design & Contract 5

Build 7

Access & Security 5

Operate 2

Company 2

Other 3

Source (apis.yml)