List spec file health metrics
Returns a paginated list of spec files (test files) with aggregated health metrics such as pass/fail counts, flakiness rate, and average duration. Useful for identifying problematic spec files across your test suite over a configurable lookback period.
Authorizations
User PAT (td_pat_) scoped to the target project
Path Parameters
The project identifier (e.g. project_abc123). Must match the project associated with your PAT.
Query Parameters
Page number for paginated results. Starts at 1.
x >= 1Page size after spec-file aggregation (1–100, default 10). Not the shared runs-list enum.
1 <= x <= 100Filter by aggregated spec status.
passed, failed, flaky, skipped Filter results by environment name (e.g. production, staging). Use the /filters endpoint to discover available environments.
Search by spec file path or name.
Lookback window in days. Values other than 7, 30, or 90 are snapped to the nearest allowed window (default 30 when absent/invalid).
7, 30, 90 Field to sort aggregated spec rows by. fullTitle falls back to fileName (no per-spec title grain).
fileName, fullTitle, executions, failureRate, flakyRate, avgDuration, lastExecution Sort direction: asc or desc (default asc).
asc, desc