Azure DevOps Runs API
Pipeline run execution and monitoring
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/microsoft-azure-devops-runs-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Azure DevOps Pipelines Runs API
description: The Azure DevOps Pipelines API provides REST endpoints for managing CI/CD build and release pipelines. APIs support pipeline creation, triggering builds, retrieving build results, managing release definitions, and automating deployment workflows across Azure DevOps organizations.
version: '7.2'
contact:
name: Microsoft Azure DevOps
url: https://learn.microsoft.com/en-us/rest/api/azure/devops/
servers:
- url: https://dev.azure.com/{organization}
description: Azure DevOps Services
variables:
organization:
description: Azure DevOps organization name
default: my-org
security:
- personalAccessToken: []
- oauth2: []
tags:
- name: Runs
description: Pipeline run execution and monitoring
paths:
/{project}/_apis/pipelines/{pipelineId}/runs:
get:
operationId: listPipelineRuns
summary: List Pipeline Runs
description: List runs for a specific pipeline.
tags:
- Runs
parameters:
- name: organization
in: path
required: true
schema:
type: string
example: example_value
- name: project
in: path
required: true
schema:
type: string
example: example_value
- name: pipelineId
in: path
required: true
schema:
type: integer
example: '500123'
- name: api-version
in: query
required: true
schema:
type: string
default: 7.2-preview.1
example: example_value
responses:
'200':
description: Pipeline runs
content:
application/json:
schema:
type: object
properties:
count:
type: integer
value:
type: array
items:
$ref: '#/components/schemas/PipelineRun'
examples:
Listpipelineruns200Example:
summary: Default listPipelineRuns 200 response
x-microcks-default: true
value:
count: 10
value:
- id: abc123
name: Example Title
state: unknown
result: unknown
createdDate: '2026-01-15T10:30:00Z'
finishedDate: '2026-01-15T10:30:00Z'
pipeline:
id: abc123
name: Example Title
resources:
repositories: example_value
variables: example_value
url: https://www.example.com
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
post:
operationId: runPipeline
summary: Run a Pipeline
description: Triggers a new run of the specified pipeline.
tags:
- Runs
parameters:
- name: organization
in: path
required: true
schema:
type: string
example: example_value
- name: project
in: path
required: true
schema:
type: string
example: example_value
- name: pipelineId
in: path
required: true
schema:
type: integer
example: '500123'
- name: api-version
in: query
required: true
schema:
type: string
default: 7.2-preview.1
example: example_value
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RunPipelineRequest'
examples:
RunpipelineRequestExample:
summary: Default runPipeline request
x-microcks-default: true
value:
resources:
repositories:
self:
refName: example_value
variables: example_value
templateParameters: example_value
stagesToSkip:
- example_value
responses:
'200':
description: Pipeline run started
content:
application/json:
schema:
$ref: '#/components/schemas/PipelineRun'
examples:
Runpipeline200Example:
summary: Default runPipeline 200 response
x-microcks-default: true
value:
id: abc123
name: Example Title
state: unknown
result: unknown
createdDate: '2026-01-15T10:30:00Z'
finishedDate: '2026-01-15T10:30:00Z'
pipeline:
id: abc123
name: Example Title
resources:
repositories: example_value
variables: example_value
url: https://www.example.com
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/{project}/_apis/pipelines/{pipelineId}/runs/{runId}:
get:
operationId: getPipelineRun
summary: Get Pipeline Run
description: Get the details of a specific pipeline run.
tags:
- Runs
parameters:
- name: organization
in: path
required: true
schema:
type: string
example: example_value
- name: project
in: path
required: true
schema:
type: string
example: example_value
- name: pipelineId
in: path
required: true
schema:
type: integer
example: '500123'
- name: runId
in: path
required: true
schema:
type: integer
example: '500123'
- name: api-version
in: query
required: true
schema:
type: string
default: 7.2-preview.1
example: example_value
responses:
'200':
description: Pipeline run details
content:
application/json:
schema:
$ref: '#/components/schemas/PipelineRun'
examples:
Getpipelinerun200Example:
summary: Default getPipelineRun 200 response
x-microcks-default: true
value:
id: abc123
name: Example Title
state: unknown
result: unknown
createdDate: '2026-01-15T10:30:00Z'
finishedDate: '2026-01-15T10:30:00Z'
pipeline:
id: abc123
name: Example Title
resources:
repositories: example_value
variables: example_value
url: https://www.example.com
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
components:
schemas:
PipelineRun:
type: object
properties:
id:
type: integer
example: abc123
name:
type: string
example: Example Title
state:
type: string
enum:
- unknown
- inProgress
- canceling
- completed
example: unknown
result:
type: string
enum:
- unknown
- succeeded
- failed
- canceled
example: unknown
createdDate:
type: string
format: date-time
example: '2026-01-15T10:30:00Z'
finishedDate:
type: string
format: date-time
example: '2026-01-15T10:30:00Z'
pipeline:
type: object
properties:
id:
type: integer
name:
type: string
example: example_value
resources:
type: object
properties:
repositories:
type: object
additionalProperties:
type: object
properties:
repository:
type: object
refName:
type: string
version:
type: string
example: example_value
variables:
type: object
additionalProperties:
type: object
properties:
value:
type: string
isSecret:
type: boolean
example: example_value
url:
type: string
example: https://www.example.com
RunPipelineRequest:
type: object
properties:
resources:
type: object
properties:
repositories:
type: object
properties:
self:
type: object
properties:
refName:
type: string
example: example_value
variables:
type: object
additionalProperties:
type: object
properties:
value:
type: string
isSecret:
type: boolean
example: example_value
templateParameters:
type: object
additionalProperties: true
example: example_value
stagesToSkip:
type: array
items:
type: string
example: []
securitySchemes:
personalAccessToken:
type: http
scheme: basic
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://app.vssps.visualstudio.com/oauth2/authorize
tokenUrl: https://app.vssps.visualstudio.com/oauth2/token
scopes:
vso.build: Read build data
vso.build_execute: Queue and manage builds