Skip to main content
GET
List spec file health metrics

Authorizations

Authorization
string
header
required

User PAT (td_pat_) scoped to the target project

Path Parameters

projectId
string
required

The project identifier (e.g. project_abc123). Must match the project associated with your PAT.

Query Parameters

page
integer
default:1

Page number for paginated results. Starts at 1.

Required range: x >= 1
limit
integer
default:10

Page size after spec-file aggregation (1–100, default 10). Not the shared runs-list enum.

Required range: 1 <= x <= 100
status
enum<string>

Filter by aggregated spec status.

Available options:
passed,
failed,
flaky,
skipped
environment
string

Filter results by environment name (e.g. production, staging). Use the /filters endpoint to discover available environments.

Search by spec file path or name.

days
enum<integer>
default:30

Lookback window in days. Values other than 7, 30, or 90 are snapped to the nearest allowed window (default 30 when absent/invalid).

Available options:
7,
30,
90
sortBy
enum<string>
default:fileName

Field to sort aggregated spec rows by. fullTitle falls back to fileName (no per-spec title grain).

Available options:
fileName,
fullTitle,
executions,
failureRate,
flakyRate,
avgDuration,
lastExecution
order
enum<string>
default:asc

Sort direction: asc or desc (default asc).

Available options:
asc,
desc

Response

Paginated spec health list

success
boolean
data
object[]
pagination
object