Get summary metrics and trends for a project across it's workflows and branches
Get summary metrics and trends for a project at workflow and branch level. Workflow runs going back at most 90 days are included in the aggregation window. Trends are only supported upto last 30 days. Please note that Insights is not a financial reporting tool and should not be used for precise credit reporting. Credit reporting from Insights does not use the same source of truth as the billing information that is found in the Plan Overview page in the CircleCI UI, nor does the underlying data have the same data accuracy guarantees as the billing information in the CircleCI UI. This may lead to discrepancies between credits reported from Insights and the billing information in the Plan Overview page of the CircleCI UI. For precise credit reporting, always use the Plan Overview page in the CircleCI UI.
Path parameters
Project slug in the form vcs-slug/org-name/repo-name. The / characters may be URL-escaped. For projects that use GitLab or GitHub App, use circleci as the vcs-slug, replace org-name with the organization ID (found in Organization Settings), and replace repo-name with the project ID (found in Project Settings).
Query parameters
The time window used to calculate summary metrics. If not provided, defaults to last-90-days
The names of VCS branches to include in branch-level workflow metrics.
The names of workflows to include in workflow-level metrics.
Response
Aggregated summary metrics and trends by workflow and branches
Example response
{
"project_workflow_data": [
{
"workflow_name": "build-and-test"
}
],
"project_workflow_branch_data": [
{
"workflow_name": "build-and-test",
"branch": "main"
}
],
"all_branches": [
"main"
],
"all_workflows": [
"build-and-test"
]
}