list_test_runs
Retrieve recent test runs for a project with filtering options by commit SHA, branch, or status to analyze test results and identify failures.
Instructions
List recent test runs for a project with optional filtering.
When using a user API Key (gaf_), you must provide a projectId. Use list_projects first to find available project IDs.
Filter by:
commitSha: Filter by commit SHA (supports prefix matching)
branch: Filter by branch name
status: Filter by "passed" (no failures) or "failed" (has failures)
Returns:
List of test runs with:
id: Test run ID (can be used with get_test_run for details)
commitSha: Git commit SHA
branch: Git branch name
passedCount/failedCount/skippedCount: Test counts
createdAt: When the test run was created
Pagination info (total count, hasMore flag)
Use cases:
"What tests failed in commit abc123?"
"Show me recent test runs on main branch"
"What's the status of tests on my feature branch?"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectId | No | Project ID to list test runs for. Required when using a user API Key (gaf_). Use list_projects to find project IDs. | |
| commitSha | No | Filter by commit SHA (exact or prefix match) | |
| branch | No | Filter by branch name | |
| status | No | Filter by status: "passed" (no failures) or "failed" (has failures) | |
| limit | No | Maximum number of test runs to return (default: 20) |