Azure Devops Api

Azure DevOps is a comprehensive DevOps platform — Boards (Agile work tracking), Repos (Git), Pipelines (CI/CD), Test Plans, and Artifacts all accessible via REST API. For agents: trigger pipeline runs, query work item status and update fields, create branches and pull requests, query build and release history, and manage artifact feeds. PAT (Personal Access Token) auth is simple. Widely used in Microsoft/Azure enterprise environments. Confidence is docs-derived.

REST API at dev.azure.com/{organization}/{project}/_apis. Pipelines: POST /_apis/pipelines/{pipelineId}/runs creates pipeline run ({templateParameters: {...}}). GET /_apis/build/builds lists builds (filter by definition, status). GET /_apis/build/builds/{buildId} retrieves build details. Work Items: POST /_apis/wit/workitems/${type} creates work item (JSON Patch body: [{op: "add", path: "/fields/System.Title", value: "Bug title"}]). GET /_apis/wit/workitems/{id} retrieves work item. PATCH /_apis/wit/workitems/{id} updates work item. Git: GET /_apis/git/repositories lists repos. POST /_apis/git/repositories/{repo}/pullrequests creates PR. GET /_apis/git/repositories/{repo}/refs?filter=heads lists branches. Releases: POST /_apis/release/releases creates a release. Query: POST /_apis/wit/wiql queries work items (WIQL — work item query language).

PAT (Personal Access Token) auth: Authorization: Basic base64(:pat) — note empty username before colon. PATs from Azure DevOps → User Settings → Personal Access Tokens. Org-scoped or project-scoped. HTTPS enforced. OAuth2: available for third-party apps (Authorization Code flow). Service principal: use with Azure AD auth for automated agents. API version: append ?api-version=7.0 to all requests (use latest stable version). Scopes: Build (read/execute), Work Items (read/write), Code (read/write), etc.

Standard HTTP status codes with JSON error bodies ({$id, innerException, message, typeName, typeKey, errorCode, eventId}). 401 for expired/invalid PAT. 404 for unknown project/pipeline. Pipeline run: async — poll run status until completed. Build validation: required reviewers and branch policies may block pipeline. Work item type: must match process template (Agile, Scrum, CMMI). WIQL: Work Item Query Language for complex cross-work-item queries — test in Boards query editor first. Azure DevOps uptime at status.dev.azure.com. Rate limiting: 200 req/min per user per org.

learn.microsoft.com/rest/api/azure/devops covers API reference for all services (Pipelines, Boards, Repos, Artifacts), authentication guide, and code samples. Getting started: Azure DevOps org (free), create PAT — first API call in under 5 minutes. azure-devops Python client: pip install azure-devops. Community via Azure DevOps Developer Community and Stack Overflow (azure-devops tag). Comprehensive documentation across a large API surface area.