Chart Data Rows — GET /api/v1/analytics/chart-data/rows
Chart Data Rows
One page of the test executions behind a chart mark, newest first.
Endpoint: GET /api/v1/analytics/chart-data/rows
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 |
|---|---|---|---|---|---|
metric | query | no | string | executions | The chart’s metric; it decides which executions count. One of: broken, duration_p50, duration_p95, duration_total, executions, failed, failure_rate, failures, flaky_tests, pass_rate, passed, retried_tests, run_count, skipped, unique_tests, unknown, wall_clock_p50, wall_clock_p95, wall_clock_total |
group_by | query | no | array of string or null | The chart’s dimensions (at most two). One of: day, week, project, release, suite, status, failure_category, branch, environment, ingestion_source, test, error_signature | |
top_n | query | no | integer or null | The chart’s top_n, when it had one. | |
bucket_day | query | no | string or null | The chart’s key for the selected day bucket. Allowed only when day is in group_by. | |
bucket_week | query | no | string or null | The chart’s key for the selected week bucket. Allowed only when week is in group_by. | |
bucket_project | query | no | string or null | The chart’s key for the selected project bucket. Allowed only when project is in group_by. | |
bucket_release | query | no | string or null | The chart’s key for the selected release bucket. Allowed only when release is in group_by. | |
bucket_suite | query | no | string or null | The chart’s key for the selected suite bucket. Allowed only when suite is in group_by. | |
bucket_status | query | no | string or null | The chart’s key for the selected status bucket. Allowed only when status is in group_by. | |
bucket_failure_category | query | no | string or null | The chart’s key for the selected failure_category bucket. Allowed only when failure_category is in group_by. | |
bucket_branch | query | no | string or null | The chart’s key for the selected branch bucket. Allowed only when branch is in group_by. | |
bucket_environment | query | no | string or null | The chart’s key for the selected environment bucket. Allowed only when environment is in group_by. | |
bucket_ingestion_source | query | no | string or null | The chart’s key for the selected ingestion_source bucket. Allowed only when ingestion_source is in group_by. | |
bucket_test | query | no | string or null | The chart’s key for the selected test bucket. Allowed only when test is in group_by. | |
bucket_error_signature | query | no | string or null | The chart’s key for the selected error_signature bucket. Allowed only when error_signature is in group_by. | |
page | query | no | integer | 1 | From 1. |
size | query | no | integer | 50 | 1-200; (page - 1) x size <= 10000. |
project_id | query | no | string or null | One project (single-valued). Omit for every project you can read. | |
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 | 30 | 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 | Not documented (application/json) |
422 | Validation Error | HTTPValidationError (application/json) |
Response fields not documented. The API specification does not describe the body of every response this endpoint returns, so this page cannot list those fields. The body is not empty. To see it, call the endpoint on your own installation. All endpoints with undocumented responses.
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: Analytics
- Operation ID:
chart_data_rows_api_v1_analytics_chart_data_rows_get - Source code:
backend/app/routers/analytics_chart_rows.py, line 45 - Specification: OpenAPI JSON