{ "opencollection": "1.0.0", "info": { "name": "Azure Pipelines Build REST Artifacts Builds API", "version": "7.1" }, "request": { "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "items": [ { "info": { "name": "Builds", "type": "folder" }, "items": [ { "info": { "name": "Azure Pipelines List builds", "type": "http" }, "http": { "method": "GET", "url": "https://dev.azure.com/{organization}/{project}/_apis/build/builds", "params": [ { "name": "api-version", "value": "", "type": "query", "description": "Azure DevOps REST API version. Use 7.1 for the latest stable version." }, { "name": "definitions", "value": "", "type": "query", "description": "Comma-delimited list of definition IDs to filter by" }, { "name": "queues", "value": "", "type": "query", "description": "Comma-delimited list of queue IDs to filter by" }, { "name": "buildNumber", "value": "", "type": "query", "description": "Filter by build number. Append asterisk for prefix matching." }, { "name": "minTime", "value": "", "type": "query", "description": "Filter to builds after this date based on the query order" }, { "name": "maxTime", "value": "", "type": "query", "description": "Filter to builds before this date based on the query order" }, { "name": "requestedFor", "value": "", "type": "query", "description": "Filter to builds requested by this user" }, { "name": "reasonFilter", "value": "", "type": "query", "description": "Filter by the reason the build was created" }, { "name": "statusFilter", "value": "", "type": "query", "description": "Filter by current build status" }, { "name": "resultFilter", "value": "", "type": "query", "description": "Filter by build result" }, { "name": "tagFilters", "value": "", "type": "query", "description": "Comma-delimited list of tags to filter by" }, { "name": "$top", "value": "", "type": "query", "description": "Maximum number of builds to return" }, { "name": "continuationToken", "value": "", "type": "query", "description": "Continuation token for paginated results" }, { "name": "maxBuildsPerDefinition", "value": "", "type": "query", "description": "Maximum number of builds to return per definition" }, { "name": "deletedFilter", "value": "", "type": "query", "description": "Filter for deleted builds" }, { "name": "queryOrder", "value": "", "type": "query", "description": "Sort order for the results" }, { "name": "branchName", "value": "", "type": "query", "description": "Filter to builds from this branch" }, { "name": "buildIds", "value": "", "type": "query", "description": "Comma-delimited list of build IDs to retrieve" }, { "name": "repositoryId", "value": "", "type": "query", "description": "Filter to builds from this repository" }, { "name": "repositoryType", "value": "", "type": "query", "description": "Filter to builds from repositories of this type" } ] }, "docs": "Returns a list of builds matching the specified filter criteria. Supports filtering by definition, status, result, branch, repository, time range, and tags. Results are paginated and can be ordered by queue time, start time, or finish time." }, { "info": { "name": "Azure Pipelines Get a build", "type": "http" }, "http": { "method": "GET", "url": "https://dev.azure.com/{organization}/{project}/_apis/build/builds/:buildId", "params": [ { "name": "api-version", "value": "", "type": "query", "description": "Azure DevOps REST API version. Use 7.1 for the latest stable version." }, { "name": "buildId", "value": "", "type": "path", "description": "Numeric ID of the build" } ] }, "docs": "Returns detailed information about a specific build including its status, result, definition, source branch, timing, and the identity that queued it." }, { "info": { "name": "Azure Pipelines Update a build", "type": "http" }, "http": { "method": "PATCH", "url": "https://dev.azure.com/{organization}/{project}/_apis/build/builds/:buildId", "params": [ { "name": "api-version", "value": "", "type": "query", "description": "Azure DevOps REST API version. Use 7.1 for the latest stable version." }, { "name": "buildId", "value": "", "type": "path", "description": "Numeric ID of the build" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Updates properties of a completed or in-progress build such as the keep-forever flag, build number, or retention status." }, { "info": { "name": "Azure Pipelines Delete a build", "type": "http" }, "http": { "method": "DELETE", "url": "https://dev.azure.com/{organization}/{project}/_apis/build/builds/:buildId", "params": [ { "name": "api-version", "value": "", "type": "query", "description": "Azure DevOps REST API version. Use 7.1 for the latest stable version." }, { "name": "buildId", "value": "", "type": "path", "description": "Numeric ID of the build" } ] }, "docs": "Deletes a build by moving it to the recycle bin. Deleted builds can be restored within the retention period." } ] } ], "bundled": true }