build_get_definitions
Retrieve a filtered list of build definitions for a specific project in Azure DevOps, enabling efficient management and querying of build configurations based on criteria like repository type, name, path, or build activity.
Instructions
Retrieves a list of build definitions for a given project.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| builtAfter | No | Return definitions that have builds after this date | |
| continuationToken | No | Token for continuing paged results | |
| definitionIds | No | Array of build definition IDs to filter | |
| includeAllProperties | No | Whether to include all properties in the results | |
| includeLatestBuilds | No | Whether to include the latest builds for each definition | |
| minMetricsTime | No | Minimum metrics time to filter build definitions | |
| name | No | Name of the build definition to filter | |
| notBuiltAfter | No | Return definitions that do not have builds after this date | |
| path | No | Path of the build definition to filter | |
| processType | No | Process type to filter build definitions | |
| project | Yes | Project ID or name to get build definitions for | |
| queryOrder | No | Order in which build definitions are returned | |
| repositoryId | No | Repository ID to filter build definitions | |
| repositoryType | No | Type of repository to filter build definitions | |
| taskIdFilter | No | Task ID to filter build definitions | |
| top | No | Maximum number of build definitions to return | |
| yamlFilename | No | YAML filename to filter build definitions |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"builtAfter": {
"description": "Return definitions that have builds after this date",
"format": "date-time",
"type": "string"
},
"continuationToken": {
"description": "Token for continuing paged results",
"type": "string"
},
"definitionIds": {
"description": "Array of build definition IDs to filter",
"items": {
"type": "number"
},
"type": "array"
},
"includeAllProperties": {
"description": "Whether to include all properties in the results",
"type": "boolean"
},
"includeLatestBuilds": {
"description": "Whether to include the latest builds for each definition",
"type": "boolean"
},
"minMetricsTime": {
"description": "Minimum metrics time to filter build definitions",
"format": "date-time",
"type": "string"
},
"name": {
"description": "Name of the build definition to filter",
"type": "string"
},
"notBuiltAfter": {
"description": "Return definitions that do not have builds after this date",
"format": "date-time",
"type": "string"
},
"path": {
"description": "Path of the build definition to filter",
"type": "string"
},
"processType": {
"description": "Process type to filter build definitions",
"type": "number"
},
"project": {
"description": "Project ID or name to get build definitions for",
"type": "string"
},
"queryOrder": {
"description": "Order in which build definitions are returned",
"enum": [
"None",
"LastModifiedAscending",
"LastModifiedDescending",
"DefinitionNameAscending",
"DefinitionNameDescending"
],
"type": "string"
},
"repositoryId": {
"description": "Repository ID to filter build definitions",
"type": "string"
},
"repositoryType": {
"description": "Type of repository to filter build definitions",
"enum": [
"TfsGit",
"GitHub",
"BitbucketCloud"
],
"type": "string"
},
"taskIdFilter": {
"description": "Task ID to filter build definitions",
"type": "string"
},
"top": {
"description": "Maximum number of build definitions to return",
"type": "number"
},
"yamlFilename": {
"description": "YAML filename to filter build definitions",
"type": "string"
}
},
"required": [
"project"
],
"type": "object"
}