Sign in

v1

latestOpenAPI 3.0.22026-07-23125563.8 KB
Tests Explorer

Get tests explorer

Get aggregated test metrics for a project within a date range. Outcomes use the RecordedTestOutcome schema (see components/schemas). For narrative context, see the Test result statuses section on the Test Explorer documentation page.

get/tests/{projectId}

Path parameters

projectIdstring required

The project ID

Query parameters

date_startstring date-time required

Start date in ISO 8601 format

date_endstring date-time required

End date in ISO 8601 format

pageinteger

Page number (0-indexed)

limitinteger

Maximum number of items to return (default: 50, max: 50)

tags[]string[]

Filter by tags (can be specified multiple times using bracket notation, e.g., tags[]=value1&tags[]=value2)

Filter by git branch. Use trailing * for prefix match (e.g. release/*). Max 250 characters per value.

groups[]string[]

Filter by groups (can be specified multiple times using bracket notation, e.g., groups[]=group1&groups[]=group2)

authors[]string[]

Filter by git authors (can be specified multiple times using bracket notation, e.g., authors[]=author1&authors[]=author2)

environments[]string[]

Filter by environment (can be specified multiple times using bracket notation, e.g., environments[]=staging&environments[]=production)

order'failures' | 'passes' | 'flakiness' | 'flakinessXSamples' | 'failRateXSamples' | 'duration' | 'durationDelta' | 'flakinessRateDelta' | 'failureRateDelta' | 'durationXSamples' | 'executions' | 'title'

Field to order results by

dir'asc' | 'desc'

Sort direction: desc (default) or asc.

specstring

Filter tests by spec file name (partial match)

titlestring

Filter tests by title (partial match)

min_executionsinteger

Minimum number of executions to include

test_state[]RecordedTestOutcome[]

Restrict default executions and avg duration slices (unless metric_settings overrides). Each value is a RecordedTestOutcome (see components/schemas). Example: test_state[]=passed&test_state[]=failed.

Overrides which outcomes feed each metric. Keys: executions, avgDuration, flakinessRate, failureRate — each value is an array of RecordedTestOutcome. Omitted keys use defaults. Pass as a JSON value (same encoding as content: application/json for this parameter).

annotationsstring

Filter by test annotations. The parameter value must be a JSON-stringified array of objects: [{ "type": "string", "description": "string" | ["string"] or null }]. description is optional; omit or set to null to match any value for that annotation.

Response

Successful response

status'OK' required