QMetry: Fetch Builds
qmetry_fetch_buildsFetch builds from a QMetry project with pagination and filters for test execution planning, reporting, and CI/CD integration.
Instructions
Fetch QMetry builds from the current project
Toolset: Projects
Parameters:
projectKey (string): Project key - unique identifier for the project (default: "default")
baseUrl (string): The base URL for the QMetry instance (must be a valid URL)
start (number): Start index for pagination - defaults to 0 (default: 0)
page (number): Page number to return (starts from 1) (default: 1)
limit (number): Number of records (default 10). (default: 10)
filter (string): Filter criteria as JSON string (default '[]') (default: "[]")
Output Description: JSON object with builds list and pagination metadata
Use Cases: 1. Fetch all from the current project 2. Fetch all available builds for test execution planning 3. Get build metadata for test run assignments 4. List builds for reporting and analytics 5. Filter builds by name or archive status 6. Get paginated build results for large projects 7. Retrieve build information for CI/CD integration 8. Search for specific builds using filters 9. Get build details for test execution history
Examples:
Get all builds (default behavior)
{}Expected Output: List of all builds with default pagination (10 items per page)
Get builds with custom pagination
{
"page": 1,
"limit": 10,
"start": 0
}Expected Output: List of builds with custom pagination settings
Filter builds by name
{
"filter": "[{\"value\":\"Build 1.0\",\"type\":\"string\",\"field\":\"name\"}]"
}Expected Output: Filtered list of builds matching the name criteria
Filter builds by archive status
{
"filter": "[{\"value\":[1,0],\"type\":\"list\",\"field\":\"isArchived\"}]"
}Expected Output: List of builds filtered by archive status (archived and non-archived)
Hints: 1. Use 'default' project key when user doesn't specify one 2. Default pagination: start=0, page=1, limit=10 3. Filter parameter should be a JSON string with filter criteria 4. Common filter fields: 'name' (string), 'isArchived' (list of 0,1) 5. Empty payload {} is sent when no parameters are provided 6. Builds are also known as 'drops' in QMetry terminology 7. Use builds for associating test executions with specific software versions
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to return (starts from 1) | |
| limit | No | Number of records (default 10). | |
| start | No | Start index for pagination - defaults to 0 | |
| filter | No | Filter criteria as JSON string (default '[]') | [] |
| baseUrl | No | The base URL for the QMetry instance (must be a valid URL) | |
| projectKey | No | Project key - unique identifier for the project | default |