Azure DevOps · Schema
BuildDefinition
A build pipeline definition in Azure DevOps
AgileCI/CDDeveloper ToolsDevOpsProject ManagementVersion Control
Properties
| Name | Type | Description |
|---|---|---|
| id | integer | Unique numeric identifier of the definition |
| name | string | Display name of the build definition |
| path | string | Folder path for organizing definitions |
| type | string | Type of build definition |
| revision | integer | Current revision number of the definition |
| quality | string | Quality of the definition |
| authoredBy | object | |
| queue | object | Default agent queue for this definition |
| project | object | |
| url | string | |
| uri | string | |
| createdDate | string | |
| queueStatus | string | Whether new builds can be queued against this definition |
| variables | object | Map of variable names to variable definitions |
| triggers | array | Triggers that automatically start this build |
| repository | object | |
| process | object | Build process definition (YAML or designer) |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/microsoft-azure-devops/json-schema/microsoft-azure-devops-build-definition-schema.json",
"title": "BuildDefinition",
"description": "A build pipeline definition in Azure DevOps",
"x-generated": "2026-11-04",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/microsoft-azure-devops-build-definitions-api-openapi.yml#/components/schemas/BuildDefinition",
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Unique numeric identifier of the definition"
},
"name": {
"type": "string",
"description": "Display name of the build definition"
},
"path": {
"type": "string",
"description": "Folder path for organizing definitions"
},
"type": {
"type": "string",
"description": "Type of build definition",
"enum": [
"xaml",
"build"
]
},
"revision": {
"type": "integer",
"description": "Current revision number of the definition"
},
"quality": {
"type": "string",
"description": "Quality of the definition",
"enum": [
"definition",
"draft"
]
},
"authoredBy": {
"$ref": "#/$defs/IdentityRef"
},
"queue": {
"type": "object",
"description": "Default agent queue for this definition",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"pool": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"isHosted": {
"type": "boolean"
}
}
}
}
},
"project": {
"$ref": "#/$defs/TeamProjectReference"
},
"url": {
"type": "string",
"format": "uri"
},
"uri": {
"type": "string"
},
"createdDate": {
"type": "string",
"format": "date-time"
},
"queueStatus": {
"type": "string",
"description": "Whether new builds can be queued against this definition",
"enum": [
"enabled",
"paused",
"disabled"
]
},
"variables": {
"type": "object",
"description": "Map of variable names to variable definitions",
"additionalProperties": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"allowOverride": {
"type": "boolean"
},
"isSecret": {
"type": "boolean"
}
}
}
},
"triggers": {
"type": "array",
"description": "Triggers that automatically start this build",
"items": {
"type": "object",
"properties": {
"triggerType": {
"type": "string",
"enum": [
"none",
"continuousIntegration",
"batchedContinuousIntegration",
"schedule",
"gatedCheckIn",
"buildCompletion",
"pullRequest"
]
}
}
}
},
"repository": {
"$ref": "#/$defs/BuildRepository"
},
"process": {
"type": "object",
"description": "Build process definition (YAML or designer)",
"properties": {
"yamlFilename": {
"type": "string",
"description": "Path to the YAML pipeline file"
},
"type": {
"type": "integer",
"description": "1 = designer, 2 = YAML"
}
}
}
},
"$defs": {
"BuildRepository": {
"type": "object",
"description": "Repository configuration for a build",
"properties": {
"id": {
"type": "string",
"description": "Repository ID (GUID for Git, name for TFVC)"
},
"name": {
"type": "string",
"description": "Repository name"
},
"type": {
"type": "string",
"description": "Repository type",
"enum": [
"TfsGit",
"TfsVersionControl",
"GitHub",
"Bitbucket",
"GitHubEnterprise"
]
},
"url": {
"type": "string",
"format": "uri",
"description": "URL of the repository"
},
"defaultBranch": {
"type": "string",
"description": "Default branch for this repository"
},
"checkoutSubmodules": {
"type": "boolean",
"description": "Whether to checkout Git submodules"
},
"clean": {
"type": "string",
"description": "Whether to clean the working directory before each build",
"enum": [
"true",
"false",
null
]
},
"properties": {
"type": "object",
"additionalProperties": true
}
}
},
"IdentityRef": {
"type": "object",
"description": "Reference to an Azure DevOps user identity",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"displayName": {
"type": "string"
},
"uniqueName": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"imageUrl": {
"type": "string",
"format": "uri"
},
"descriptor": {
"type": "string"
}
}
},
"TeamProjectReference": {
"type": "object",
"description": "Reference to an Azure DevOps project",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Project ID"
},
"name": {
"type": "string",
"description": "Project name"
},
"description": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"state": {
"type": "string",
"enum": [
"deleting",
"new",
"wellFormed",
"createPending",
"all",
"unchanged",
"deleted"
]
},
"visibility": {
"type": "string",
"enum": [
"private",
"public"
]
},
"revision": {
"type": "integer"
}
}
}
}
}
Work with this as data
Every JSON Schema 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 schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.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 JSON Schema
curl "https://apis.io/api/v1/json-schemas/microsoft-azure-devops-build-definition"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.