build_get_builds
Fetch and filter build data from Azure DevOps projects using criteria like build ID, status, branch, or requester. Ideal for tracking and analyzing build history.
Instructions
Retrieves a list of builds for a given project.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| branchName | No | Branch name to filter builds | |
| buildIds | No | Array of build IDs to retrieve | |
| buildNumber | No | Build number to filter builds | |
| continuationToken | No | Token for continuing paged results | |
| definitions | No | Array of build definition IDs to filter builds | |
| deletedFilter | No | Filter for deleted builds (see QueryDeletedOption enum) | |
| maxBuildsPerDefinition | No | Maximum number of builds per definition | |
| maxTime | No | Maximum finish time to filter builds | |
| minTime | No | Minimum finish time to filter builds | |
| project | Yes | Project ID or name to get builds for | |
| properties | No | Array of property names to include in the results | |
| queryOrder | No | Order in which builds are returned | QueueTimeDescending |
| queues | No | Array of queue IDs to filter builds | |
| reasonFilter | No | Reason filter for the build (see BuildReason enum) | |
| repositoryId | No | Repository ID to filter builds | |
| repositoryType | No | Type of repository to filter builds | |
| requestedFor | No | User ID or name who requested the build | |
| resultFilter | No | Result filter for the build (see BuildResult enum) | |
| statusFilter | No | Status filter for the build (see BuildStatus enum) | |
| tagFilters | No | Array of tags to filter builds | |
| top | No | Maximum number of builds to return |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"branchName": {
"description": "Branch name to filter builds",
"type": "string"
},
"buildIds": {
"description": "Array of build IDs to retrieve",
"items": {
"type": "number"
},
"type": "array"
},
"buildNumber": {
"description": "Build number to filter builds",
"type": "string"
},
"continuationToken": {
"description": "Token for continuing paged results",
"type": "string"
},
"definitions": {
"description": "Array of build definition IDs to filter builds",
"items": {
"type": "number"
},
"type": "array"
},
"deletedFilter": {
"description": "Filter for deleted builds (see QueryDeletedOption enum)",
"type": "number"
},
"maxBuildsPerDefinition": {
"description": "Maximum number of builds per definition",
"type": "number"
},
"maxTime": {
"description": "Maximum finish time to filter builds",
"format": "date-time",
"type": "string"
},
"minTime": {
"description": "Minimum finish time to filter builds",
"format": "date-time",
"type": "string"
},
"project": {
"description": "Project ID or name to get builds for",
"type": "string"
},
"properties": {
"description": "Array of property names to include in the results",
"items": {
"type": "string"
},
"type": "array"
},
"queryOrder": {
"default": "QueueTimeDescending",
"description": "Order in which builds are returned",
"enum": [
"FinishTimeAscending",
"FinishTimeDescending",
"QueueTimeDescending",
"QueueTimeAscending",
"StartTimeDescending",
"StartTimeAscending"
],
"type": "string"
},
"queues": {
"description": "Array of queue IDs to filter builds",
"items": {
"type": "number"
},
"type": "array"
},
"reasonFilter": {
"description": "Reason filter for the build (see BuildReason enum)",
"type": "number"
},
"repositoryId": {
"description": "Repository ID to filter builds",
"type": "string"
},
"repositoryType": {
"description": "Type of repository to filter builds",
"enum": [
"TfsGit",
"GitHub",
"BitbucketCloud"
],
"type": "string"
},
"requestedFor": {
"description": "User ID or name who requested the build",
"type": "string"
},
"resultFilter": {
"description": "Result filter for the build (see BuildResult enum)",
"type": "number"
},
"statusFilter": {
"description": "Status filter for the build (see BuildStatus enum)",
"type": "number"
},
"tagFilters": {
"description": "Array of tags to filter builds",
"items": {
"type": "string"
},
"type": "array"
},
"top": {
"description": "Maximum number of builds to return",
"type": "number"
}
},
"required": [
"project"
],
"type": "object"
}