Get a build metrics time series for a project
GET/workspaces/:workspace_slug/builds/series
The same metrics as builds/totals, grouped by time granularity: one row per bucket, oldest first, each carrying every metric. Pass 'group_by' to add a dimension (workflow, pipeline, stage, step): rows keep the same shape and gain that label, groups are ranked by build count and capped by 'limit'. The window may span at most 7 days hourly, 90 days daily, 1 year weekly and 2 years monthly.
Grouped, the response has one row per bucket per group - for example per day per workflow - and each row names its group in the matching field ('workflow' here).
RequestClick to copy link
ResponsesClick to copy link
- 200
- 400
- 401
- 402
- 403
- 422
- 429
- 500
- 503
OK
a required parameter is missing, or a value is malformed
the Authorization header is missing or malformed
the workspace has no paid Insights plan
the token is rejected, or has no access to this workspace or project
a parameter value is outside its accepted set or range
rate limit exceeded; a plain text body of 'Too Many Requests', with a Retry-After header and the X-RateLimit-* headers
unexpected error
authorization is temporarily unavailable; the request may be retried