Get Suite Execution History — GET /api/v1/analytics/execution/suite-history
Get Suite Execution History
One suite’s wall clock and summed test time per run over the window (oldest first), with window p50/p95 over every execution in it. suite_name is required and single-valued here (matched trimmed and case-insensitively); release_id filters the runs.
Endpoint: GET /api/v1/analytics/execution/suite-history
Authentication: Send a signed-in user’s access token in Authorization: Bearer <access token>, or an API key in X-API-Key: <API key>.
Parameters
Section titled “Parameters”| Name | In | Required | Type | Default | Description |
|---|---|---|---|---|---|
branch | query | no | string or null | Only runs of this branch (exact, case-sensitive, 1-255 characters). Absent or empty: every branch. | |
limit | query | no | integer | 100 | Max points, 1-500 (the newest are kept). |
project_id | query | yes | string | Project to read. Single-valued. Required: without it the request is refused with 422 ‘missing_parameter’ (All Projects is not supported here). | |
release_id | query | no | array of string or null | Repeatable (OR, at most 20): a release UUID or ‘unattributed’ for runs no release claims. | |
suite_name | query | no | array of string or null | Repeatable (OR, at most 50), 1-500 characters; matched case-insensitively on the effective suite. | |
days | query | no | integer | 90 | Window in days, 1-365. |
X-API-Key | header | no | string or null | API key, as an alternative to the access token (see Authentication). |
Request body
Section titled “Request body”No request body.
Responses
Section titled “Responses”| Status | Meaning | Body |
|---|---|---|
200 | Successful Response | SuiteExecutionHistoryResponse (application/json) |
422 | Validation Error | HTTPValidationError (application/json) |
It can also return 401 if your credential is missing or expired, 403 if your credential does not allow this request, and 404 if the item does not exist or you cannot see it. Your role, your project membership and the key’s scope decide what a credential allows. See Errors and retries.
More details
Section titled “More details”- Group: Execution Metrics
- Tags:
Execution Metrics,Analytics - Operation ID:
get_suite_execution_history_api_v1_analytics_execution_suite_history_get - Source code:
backend/app/routers/execution_metrics.py, line 83 - Specification: OpenAPI JSON