list_builds
Retrieve and filter TeamCity builds by project, type, or status with pagination support for efficient CI/CD monitoring.
Instructions
List TeamCity builds (supports pagination)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| all | No | Fetch all pages up to maxPages | |
| buildTypeId | No | Filter by build type ID | |
| count | No | Deprecated: use pageSize | |
| fields | No | Optional fields selector for server-side projection | |
| locator | No | Optional build locator to filter builds | |
| maxPages | No | Max pages to fetch (when all=true) | |
| pageSize | No | Items per page (default 100) | |
| projectId | No | Filter by project ID | |
| status | No | Filter by status |
Input Schema (JSON Schema)
{
"properties": {
"all": {
"description": "Fetch all pages up to maxPages",
"type": "boolean"
},
"buildTypeId": {
"description": "Filter by build type ID",
"type": "string"
},
"count": {
"default": 10,
"description": "Deprecated: use pageSize",
"type": "number"
},
"fields": {
"description": "Optional fields selector for server-side projection",
"type": "string"
},
"locator": {
"description": "Optional build locator to filter builds",
"type": "string"
},
"maxPages": {
"description": "Max pages to fetch (when all=true)",
"type": "number"
},
"pageSize": {
"description": "Items per page (default 100)",
"type": "number"
},
"projectId": {
"description": "Filter by project ID",
"type": "string"
},
"status": {
"description": "Filter by status",
"enum": [
"SUCCESS",
"FAILURE",
"ERROR"
],
"type": "string"
}
},
"type": "object"
}