List Test Controls
list_test_controlsRetrieves quarantined, critical, watched, or flaky-candidate tests from a project's Test Controls, filtered by state, search, or assignee, so you can review which tests need action.
Instructions
List the tests under Test Controls in a project, as the Test Controls page shows them. view "quarantined" (default) lists quarantines — filter by state (active, ending_soon, released), covers (any failure or one error) and, for released ones, reason; the response includes the quarantine budget. view "critical" lists tests marked critical, view "watched" lists the tests you watch, view "candidates" lists flaky tests that failed a build in the last 30 days (a test that always passed on retry is not listed, since quarantining it would change nothing). search matches the test title or file; assignee takes "me", a user id or an email. Quarantine settings (budget, default length, auto-release) are changed only in the app, not here.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>"
},
"name": "list_test_controls"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| view | No | Default "quarantined" | |
| limit | No | Default 25 (50 for candidates, max 200 there) | |
| state | No | quarantined view only. Default "active" | |
| covers | No | quarantined view only: "any" failure or one "error" | |
| reason | No | Release reason; only with state "released" | |
| search | No | Match the test title or file | |
| assignee | No | "me", a user id or an email. Not for the candidates view | |
| projectId | Yes | Project ID (e.g. project_<id>) |