> For the complete documentation index, see [llms.txt](https://docs.multitudes.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.multitudes.com/knowledge-base/multitudes-api.md).

# Multitudes API

Export data from Multitudes via API

The Multitudes API is a public REST API that lets you interact with the Multitudes app programmatically. You can query chart data, retrieve the underlying records (drilldown data) for the metrics that support it, and retrieve metadata about your organization.

All data is returned in a consistent JSON format that makes it easy to combine with other data sources or build custom workflows around your engineering data.

Prefer to query your data from an AI assistant? See the [Multitudes MCP Server](https://docs.multitudes.com/knowledge-base/mcp-server.md).

## Before you start

All endpoints are served from `https://api.multitudes.co`. An OpenAPI spec is available without authentication at [`https://api.multitudes.co/v1/openapi.json`](https://api.multitudes.co/v1/openapi.json).

Authenticate using an organization API key passed as `Authorization: Bearer <token>`. Keys must have the `data:read` scope to access metric endpoints. See how to generate an API key [here](https://docs.multitudes.com/configuration-and-setup/api-keys.md).

## Rate limits

Current rate limits are as follows:

* 6 requests per second
* 30 requests per minute
* 150 requests per hour

These limits are per key and are set to ensure API and app performance with the API load we're expecting. We'll be monitoring API usage and revisiting these rate limits over time.

## Working with chart data

### Find what a metric accepts

Not every metric accepts every query parameter. `GET /v1/metrics` lists each metric's accepted optional parameters and whether it supports drilldown. Check it before using a parameter such as `view`, `individual` or `groupBy`.

### Date ranges

`from` and `to` are calendar days in your organization's timezone. The time of day is ignored, and `to` is inclusive, so `to=2026-11-10` includes all of 10 November. Data is bucketed by `timescale` (`daily`, `weekly` or `monthly`). Timestamps in responses are ISO 8601 in UTC, so for an organization behind UTC the end of a day can appear as early the next day.

For example, weekly lead time for one team over October:

```bash
curl "https://api.multitudes.co/v1/charts/leadTime?from=2026-10-01&to=2026-10-31&timescale=weekly&teamNames=Platform" \
  -H "Authorization: Bearer <your-api-key>"
```

### Reading the response

* Each series has `dataPoints`, one per time bucket. With `view=aggregate`, there is instead one data point per category for the whole period, each with a `label`. Most metrics also have `aggregateData`: a single data point for the whole period. Use it for a period-wide figure instead of combining buckets.
* The response includes an organization-wide series alongside your teams. Pass `excludeOrganization=true` to leave it out.
* With `view=aggregate`, the response for `githubFeatureVsMaintenance` leaves out `from`, `to` and `timescale`. `leadTime` keeps them.

### Grouping and per-person data

* `groupBy=repository` works only for pull request metrics. It returns one series per repository, with no team or organization series. Organizations can have hundreds of repositories, so pass `repositories` (comma-separated names) to limit the series. `GET /v1/repositories` lists names, but only for repositories with activity in the last 12 weeks.
* `individual=true` returns one series per team member, and only for metrics that accept it.

### Drilldown

`GET /v1/charts/{metricType}/drilldown` returns the underlying records, such as pull requests, for metrics that support it. It accepts the same filters as the chart endpoint, plus `limit`. To read more, pass the `nextCursor` from the response as `cursor`. When `nextCursor` is absent, there are no more results. Drilldown doesn't support `groupBy=repository`.

## Versioning

All endpoints are versioned, with the current version being v1.

## Endpoints

## List teams

> Returns the organization's teams, active teams first, each group sorted by name. Archived teams are included only when \`includeArchived\` is true.

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"servers":[{"url":"/"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"Authorization: Bearer <token>. A raw token in the Authorization header is also accepted for backward compatibility."}},"schemas":{"TeamsResponseDto":{"type":"object","properties":{"items":{"description":"List of teams.","type":"array","items":{"$ref":"#/components/schemas/TeamDto"}}},"required":["items"]},"TeamDto":{"type":"object","properties":{"id":{"type":"string","description":"Team UUID."},"name":{"type":"string","description":"Team display name."},"status":{"type":"string","description":"Team status.","enum":["active","archived"]}},"required":["id","name","status"]}}},"paths":{"/v1/teams":{"get":{"description":"Returns the organization's teams, active teams first, each group sorted by name. Archived teams are included only when `includeArchived` is true.","parameters":[{"name":"includeArchived","required":false,"in":"query","description":"When true, archived teams are included in the response.","schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamsResponseDto"}}}}},"summary":"List teams","tags":["customer"]}}}}
```

## List GitHub repositories

> Returns the repository names, sorted by name, to use in the \`repositories\` filter of chart requests. Only repositories with recent activity (pushed in the last 12 weeks) are listed, so a repository with only older activity can still appear in chart data. An empty list is also returned if GitHub could not be reached.

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"servers":[{"url":"/"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"Authorization: Bearer <token>. A raw token in the Authorization header is also accepted for backward compatibility."}},"schemas":{"RepositoriesResponseDto":{"type":"object","properties":{"items":{"description":"Repositories, sorted by name.","type":"array","items":{"$ref":"#/components/schemas/RepositoryDto"}}},"required":["items"]},"RepositoryDto":{"type":"object","properties":{"name":{"type":"string","description":"Repository name without the organization, as used by the repositories filter."}},"required":["name"]}}},"paths":{"/v1/repositories":{"get":{"description":"Returns the repository names, sorted by name, to use in the `repositories` filter of chart requests. Only repositories with recent activity (pushed in the last 12 weeks) are listed, so a repository with only older activity can still appear in chart data. An empty list is also returned if GitHub could not be reached.","parameters":[],"responses":{"200":{"description":"The organization's repositories, sorted by name.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RepositoriesResponseDto"}}}},"404":{"description":"GitHub is not connected for this organization."}},"summary":"List GitHub repositories","tags":["customer"]}}}}
```

## List supported metrics

> Returns each metric with a description and the optional query parameters it accepts beyond the standard ones (from, to, timescale, teamIds, teamNames).

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"servers":[{"url":"/"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"Authorization: Bearer <token>. A raw token in the Authorization header is also accepted for backward compatibility."}},"schemas":{"MetricsListResponseDto":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/MetricInfoDto"}}},"required":["items"]},"MetricInfoDto":{"type":"object","properties":{"type":{"type":"string","description":"Metric type identifier.","enum":["leadTime","codingTime","reviewWaitTime","editingTime","mergeWaitTime","deployTime","mergeFrequency","changeFailureRate","linesOfCodeChanged","filesChanged","deploymentFailureRate","commitsOutOfHours","deploymentFrequency","feedbackGiven","feedbackReceived","feedbackParticipationGap","githubFeatureVsMaintenance","aiActiveUsers","aiIntensityOfUsage","aiCohortDistribution","focusTimeGoogle","focusTimeOutlook","meetingHoursGoogle","meetingHoursOutlook","meetingHoursOohGoogle","meetingHoursOohOutlook","feedbackQuality","feedbackThemes","pagerdutyMeanTimeToRestore","pagerdutyMeanTimeToAcknowledge","pagerdutyPageDisruptions","pagerdutyPageDisruptionsOoh","pagerdutyNumberOfPages","jiraTypeOfWork","jiraFeatureVsMaintenance","linearTypeOfWork","linearFeatureVsMaintenance"]},"description":{"type":"string","description":"Human-readable description of what this metric measures."},"acceptedQueryParams":{"description":"Optional query parameters supported by this metric, beyond the standard ones (from, to, timescale, teamIds, teamNames).","type":"array","items":{"type":"string"}},"drilldown":{"type":"boolean","description":"Whether GET /v1/charts/:metricType/drilldown is supported for this metric."},"docsUrl":{"type":"string","description":"Help center page that defines this metric. Append .md for the plain-text version."}},"required":["type","description","acceptedQueryParams","drilldown","docsUrl"]}}},"paths":{"/v1/metrics":{"get":{"description":"Returns each metric with a description and the optional query parameters it accepts beyond the standard ones (from, to, timescale, teamIds, teamNames).","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetricsListResponseDto"}}}}},"summary":"List supported metrics","tags":["customer"]}}}}
```

## Retrieve chart data

> Returns time-series or aggregate chart data for the specified metric. Use GET /v1/metrics to discover supported metrics and their accepted query parameters.

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"servers":[{"url":"/"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"Authorization: Bearer <token>. A raw token in the Authorization header is also accepted for backward compatibility."}},"schemas":{"ChartResponseDto":{"type":"object","properties":{"metricType":{"type":"string","description":"Metric type identifier."},"from":{"type":"string","description":"Query start date as ISO 8601 timestamp. Absent for the githubFeatureVsMaintenance aggregate view; present for the leadTime aggregate view."},"to":{"type":"string","description":"Query end date as ISO 8601 timestamp. Absent for the githubFeatureVsMaintenance aggregate view; present for the leadTime aggregate view."},"timescale":{"type":"string","description":"Timescale used for data point bucketing. Absent for the githubFeatureVsMaintenance aggregate view; present for the leadTime aggregate view, where it has no effect because the whole period is one bucket.","enum":["daily","weekly","monthly"]},"options":{"description":"Echoes the options applied to the request, plus read-only settings the server chose.","allOf":[{"$ref":"#/components/schemas/ChartOptionsDto"}]},"series":{"description":"Chart series.","type":"array","items":{"$ref":"#/components/schemas/SeriesDto"}},"units":{"description":"Unit of measurement for this metric's values. A plain string for all metrics except aiIntensityOfUsage, which returns an object keyed by value field (spend, inputTokens, linesChanged) since that metric emits three parallel units per data point.","oneOf":[{"type":"string"},{"type":"object","additionalProperties":{"type":"string"}}]}},"required":["metricType","options","series","units"]},"ChartOptionsDto":{"type":"object","properties":{"repositories":{"description":"Repository names the response was filtered to.","type":"array","items":{"type":"string"}},"excludeOrganization":{"type":"boolean","description":"Whether the org-level rollup series was excluded from the response."},"excludeWeekendHours":{"type":"boolean","description":"Whether weekend hours were excluded."},"includeSelfiePrs":{"type":"boolean","description":"Whether self-review PRs were included."},"defaultBranchOnly":{"type":"boolean","description":"Whether only default-branch commits/PRs were included."},"view":{"type":"string","description":"View that was applied.","enum":["timeSeries","aggregate"]},"direction":{"type":"string","description":"Feedback direction. Applies to feedbackQuality and feedbackThemes metrics.","enum":["given","received"]},"groupBy":{"type":"string","description":"How to group chart series. Defaults to team. AI metrics support: jobLevel, timezone, aiTool, nonContributors. PagerDuty metrics support: service, escalationPolicy. Pull request metrics support: repository.","enum":["team","service","escalationPolicy","jobLevel","timezone","aiTool","nonContributors","repository"]},"cohortMetric":{"type":"string","description":"Cohort metric used to classify users (aiCohortDistribution only). Set by the server, not a request parameter.","enum":["dailyActiveUsage","spend","inputTokens","linesChanged"]},"cohortThreshold":{"type":"number","description":"Threshold value used to split High/Low AI cohorts (aiCohortDistribution only). Unit depends on cohortMetric: percentage of active days for 'dailyActiveUsage', USD cents for 'spend', token count for 'inputTokens', line count for 'linesChanged'. Set by the server, not a request parameter."},"cohortLookbackWeeks":{"type":"number","description":"Number of lookback weeks used for cohort classification (aiCohortDistribution only). Set by the server, not a request parameter."},"individual":{"type":"boolean","description":"Whether one series per team member was returned instead of one per team.","default":false},"countBy":{"type":"string","description":"Unit that was counted by.","enum":["issues","storyPoints","comments","reviews","pages","disruptedHours"]},"priorities":{"description":"PagerDuty priority IDs the response was filtered to (PagerDuty metrics only).","type":"array","items":{"type":"string"}},"urgencies":{"type":"array","description":"Urgency levels the response was filtered to (PagerDuty metrics only).","items":{"type":"string","enum":["high","low"]}}}},"SeriesDto":{"type":"object","properties":{"id":{"type":"string","description":"Series identifier. For team series: team UUID. For cohort series: cohort name. For repository series: repository name."},"name":{"type":"string","description":"Display name for the series."},"type":{"type":"string","description":"Series type.","enum":["team","organization","member","cohort","repository"]},"dataPoints":{"description":"Ordered list of data points for this series.","type":"array","items":{"$ref":"#/components/schemas/DataPointDto"}},"aggregateData":{"description":"The whole requested period as a single data point, with the same fields as a data point and no label: the value (or percentiles) over the entire range rather than per time bucket, and memberCount averaged across the buckets weighted by their length. Omitted for metrics where it is not available.","allOf":[{"$ref":"#/components/schemas/DataPointDto"}]}},"required":["id","name","type","dataPoints"]},"DataPointDto":{"type":"object","properties":{"startDate":{"type":"string","description":"Bucket start date (ISO 8601)."},"endDate":{"type":"string","description":"Bucket end date (ISO 8601)."},"value":{"type":"number","description":"Metric value. Omitted for comment metrics (commentsGiven, commentsReceived, commentsParticipationRatio) and when percentile data (p50/p75/p90/p95) is present."},"p50":{"type":"number","description":"50th percentile value. Present when percentile data is available. Null indicates no data for this bucket.","nullable":true},"p75":{"type":"number","description":"75th percentile value. Present when percentile data is available. Null indicates no data for this bucket.","nullable":true},"p90":{"type":"number","description":"90th percentile value. Present when percentile data is available. Null indicates no data for this bucket.","nullable":true},"p95":{"type":"number","description":"95th percentile value. Present when percentile data is available. Null indicates no data for this bucket.","nullable":true},"count":{"type":"number","description":"Number of data points considered in this bucket (e.g. PRs, commits, issues). Null indicates no data for this bucket.","nullable":true},"memberCount":{"type":"number","description":"Number of people considered in this bucket (team members in scope for the data point). Null indicates no data for this bucket.","nullable":true},"spend":{"type":"number","description":"Total AI spend in USD cents for this bucket. Present for aiIntensityOfUsage.","nullable":true},"inputTokens":{"type":"number","description":"Total input tokens consumed for this bucket. Present for aiIntensityOfUsage.","nullable":true},"linesChanged":{"type":"number","description":"Total lines of code accepted for this bucket. Present for aiIntensityOfUsage.","nullable":true},"total":{"type":"number","description":"Total (sum) value for this bucket. Null indicates no data for this bucket.","nullable":true},"label":{"type":"string","description":"Category label for aggregate view data points (e.g. 'Feature', 'Bug'). Only present for githubFeatureVsMaintenance and leadTime when view=aggregate."}},"required":["startDate","endDate"]}}},"paths":{"/v1/charts/{metricType}":{"get":{"description":"Returns time-series or aggregate chart data for the specified metric. Use GET /v1/metrics to discover supported metrics and their accepted query parameters.","parameters":[{"name":"from","required":true,"in":"query","description":"Start of the date range as an ISO 8601 datetime. Required. Only the calendar day is used, in the organisation's timezone (the time of day is ignored); the range starts at the beginning of that day.","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","description":"End of the date range as an ISO 8601 datetime. Required. Only the calendar day is used, in the organisation's timezone (the time of day is ignored); that day is inclusive, so the range ends at the end of that day.","schema":{"type":"string"}},{"name":"timescale","required":false,"in":"query","description":"Timescale for bucketing data points.","schema":{"default":"weekly","enum":["daily","weekly","monthly"],"type":"string"}},{"name":"teamIds","required":false,"in":"query","description":"Comma-separated team IDs to filter (mutually exclusive with teamNames, max 50).","schema":{"type":"string"}},{"name":"teamNames","required":false,"in":"query","description":"Comma-separated team names to filter (mutually exclusive with teamIds, max 50).","schema":{"type":"string"}},{"name":"repositories","required":false,"in":"query","description":"Comma-separated repository names to filter. List the names with GET /v1/repositories (the list_repositories tool in MCP). Only for metrics that list `repositories` in acceptedQueryParams (GET /v1/metrics; the list_metrics tool in MCP).","schema":{"type":"string"}},{"name":"excludeWeekendHours","required":false,"in":"query","description":"Exclude weekend hours from calculations. Only for metrics that list `excludeWeekendHours` in acceptedQueryParams (GET /v1/metrics; the list_metrics tool in MCP).","schema":{"default":false,"type":"boolean"}},{"name":"includeSelfiePrs","required":false,"in":"query","description":"Include PRs where the author also reviewed. Default false. Only for metrics that list `includeSelfiePrs` in acceptedQueryParams (GET /v1/metrics; the list_metrics tool in MCP).","schema":{"default":false,"type":"boolean"}},{"name":"defaultBranchOnly","required":false,"in":"query","description":"Limit to commits/PRs on default branch only. Only for metrics that list `defaultBranchOnly` in acceptedQueryParams (GET /v1/metrics; the list_metrics tool in MCP).","schema":{"default":false,"type":"boolean"}},{"name":"excludeOrganization","required":false,"in":"query","description":"Exclude the org-level rollup series from the response. Default false.","schema":{"default":false,"type":"boolean"}},{"name":"view","required":false,"in":"query","description":"How to present the data: timeSeries (default) gives one data point per time bucket; aggregate gives one data point per category or stage over the whole period. Only for metrics that list `view` in acceptedQueryParams (GET /v1/metrics; the list_metrics tool in MCP).","schema":{"enum":["timeSeries","aggregate"],"type":"string"}},{"name":"groupBy","required":false,"in":"query","description":"How to group chart series. Defaults to team. AI metrics support: jobLevel, timezone, aiTool, nonContributors. PagerDuty metrics support: service, escalationPolicy. Pull request metrics (those listing groupBy in list_metrics) support: repository, which returns one series per repository; teamIds/teamNames only choose whose pull requests are included, and no team or organization series are returned. Combine with repositories to limit the number of series.","schema":{"default":"team","enum":["team","service","escalationPolicy","jobLevel","timezone","aiTool","nonContributors","repository"],"type":"string"}},{"name":"individual","required":false,"in":"query","description":"When true, return one series per team member instead of per team. Covers meeting hours, PR stage times (coding, review wait, editing, merge wait, deploy), feedback given and received, commits out of hours, and PagerDuty page disruptions; lead time is not included. Only for metrics that list `individual` in acceptedQueryParams (GET /v1/metrics; the list_metrics tool in MCP).","schema":{"default":false,"type":"boolean"}},{"name":"countBy","required":false,"in":"query","description":"Unit to count by. Issue tracker metrics: issues (default) or storyPoints. GitHub feedback metrics: comments (default) or reviews. Page disruption metrics: pages (default) or disruptedHours. Only for metrics that list `countBy` in acceptedQueryParams (GET /v1/metrics; the list_metrics tool in MCP).","schema":{"enum":["issues","storyPoints","comments","reviews","pages","disruptedHours"],"type":"string"}},{"name":"direction","required":false,"in":"query","description":"Direction for feedback quality/themes metrics: 'given' (comments the team wrote) or 'received' (comments written on the team's PRs). Default given.","schema":{"default":"given","enum":["given","received"],"type":"string"}},{"name":"priorities","required":false,"in":"query","description":"Comma-separated PagerDuty priority IDs to filter by (PagerDuty metrics only). Use the priority IDs from your PagerDuty configuration.","schema":{"type":"string"}},{"name":"urgencies","required":false,"in":"query","description":"Comma-separated urgency levels to filter by (PagerDuty metrics only). Valid values: high, low.","schema":{"type":"string"}},{"name":"metricType","required":true,"in":"path","description":"The metric to retrieve.","schema":{"enum":["leadTime","codingTime","reviewWaitTime","editingTime","mergeWaitTime","deployTime","mergeFrequency","changeFailureRate","linesOfCodeChanged","filesChanged","deploymentFailureRate","commitsOutOfHours","deploymentFrequency","feedbackGiven","feedbackReceived","feedbackParticipationGap","githubFeatureVsMaintenance","aiActiveUsers","aiIntensityOfUsage","aiCohortDistribution","focusTimeGoogle","focusTimeOutlook","meetingHoursGoogle","meetingHoursOutlook","meetingHoursOohGoogle","meetingHoursOohOutlook","feedbackQuality","feedbackThemes","pagerdutyMeanTimeToRestore","pagerdutyMeanTimeToAcknowledge","pagerdutyPageDisruptions","pagerdutyPageDisruptionsOoh","pagerdutyNumberOfPages","jiraTypeOfWork","jiraFeatureVsMaintenance","linearTypeOfWork","linearFeatureVsMaintenance"],"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChartResponseDto"}}}},"400":{"description":"Invalid query parameters."},"404":{"description":"Metric type not found or not available for your organization."}},"summary":"Retrieve chart data","tags":["customer"]}}}}
```

## Retrieve drilldown records

> Returns individual raw records (e.g. pull requests) contributing to the metric, cursor-paginated. Accepts the same query parameters as GET /v1/charts/:metricType, plus \`cursor\` and \`limit\`. Not every metric supports drilldown — check GET /v1/metrics for the \`drilldown\` flag.

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"servers":[{"url":"/"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"Authorization: Bearer <token>. A raw token in the Authorization header is also accepted for backward compatibility."}},"schemas":{"DrilldownResponseDto":{"type":"object","properties":{"metricType":{"type":"string","description":"Metric type identifier."},"options":{"description":"Echoes options that were explicitly provided in the request.","allOf":[{"$ref":"#/components/schemas/ChartOptionsDto"}]},"items":{"description":"Raw records for the current page. Shape varies by metric.","type":"array","items":{"type":"string"}},"nextCursor":{"type":"string","description":"Cursor to fetch the next page. Absent when there are no more results."}},"required":["metricType","options","items"]},"ChartOptionsDto":{"type":"object","properties":{"repositories":{"description":"Repository names the response was filtered to.","type":"array","items":{"type":"string"}},"excludeOrganization":{"type":"boolean","description":"Whether the org-level rollup series was excluded from the response."},"excludeWeekendHours":{"type":"boolean","description":"Whether weekend hours were excluded."},"includeSelfiePrs":{"type":"boolean","description":"Whether self-review PRs were included."},"defaultBranchOnly":{"type":"boolean","description":"Whether only default-branch commits/PRs were included."},"view":{"type":"string","description":"View that was applied.","enum":["timeSeries","aggregate"]},"direction":{"type":"string","description":"Feedback direction. Applies to feedbackQuality and feedbackThemes metrics.","enum":["given","received"]},"groupBy":{"type":"string","description":"How to group chart series. Defaults to team. AI metrics support: jobLevel, timezone, aiTool, nonContributors. PagerDuty metrics support: service, escalationPolicy. Pull request metrics support: repository.","enum":["team","service","escalationPolicy","jobLevel","timezone","aiTool","nonContributors","repository"]},"cohortMetric":{"type":"string","description":"Cohort metric used to classify users (aiCohortDistribution only). Set by the server, not a request parameter.","enum":["dailyActiveUsage","spend","inputTokens","linesChanged"]},"cohortThreshold":{"type":"number","description":"Threshold value used to split High/Low AI cohorts (aiCohortDistribution only). Unit depends on cohortMetric: percentage of active days for 'dailyActiveUsage', USD cents for 'spend', token count for 'inputTokens', line count for 'linesChanged'. Set by the server, not a request parameter."},"cohortLookbackWeeks":{"type":"number","description":"Number of lookback weeks used for cohort classification (aiCohortDistribution only). Set by the server, not a request parameter."},"individual":{"type":"boolean","description":"Whether one series per team member was returned instead of one per team.","default":false},"countBy":{"type":"string","description":"Unit that was counted by.","enum":["issues","storyPoints","comments","reviews","pages","disruptedHours"]},"priorities":{"description":"PagerDuty priority IDs the response was filtered to (PagerDuty metrics only).","type":"array","items":{"type":"string"}},"urgencies":{"type":"array","description":"Urgency levels the response was filtered to (PagerDuty metrics only).","items":{"type":"string","enum":["high","low"]}}}}}},"paths":{"/v1/charts/{metricType}/drilldown":{"get":{"description":"Returns individual raw records (e.g. pull requests) contributing to the metric, cursor-paginated. Accepts the same query parameters as GET /v1/charts/:metricType, plus `cursor` and `limit`. Not every metric supports drilldown — check GET /v1/metrics for the `drilldown` flag.","parameters":[{"name":"from","required":true,"in":"query","description":"Start of the date range as an ISO 8601 datetime. Required. Only the calendar day is used, in the organisation's timezone (the time of day is ignored); the range starts at the beginning of that day.","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","description":"End of the date range as an ISO 8601 datetime. Required. Only the calendar day is used, in the organisation's timezone (the time of day is ignored); that day is inclusive, so the range ends at the end of that day.","schema":{"type":"string"}},{"name":"teamIds","required":false,"in":"query","description":"Comma-separated team IDs to filter (mutually exclusive with teamNames, max 50).","schema":{"type":"string"}},{"name":"teamNames","required":false,"in":"query","description":"Comma-separated team names to filter (mutually exclusive with teamIds, max 50).","schema":{"type":"string"}},{"name":"repositories","required":false,"in":"query","description":"Comma-separated repository names to filter. List the names with GET /v1/repositories (the list_repositories tool in MCP). Only for metrics that list `repositories` in acceptedQueryParams (GET /v1/metrics; the list_metrics tool in MCP).","schema":{"type":"string"}},{"name":"includeSelfiePrs","required":false,"in":"query","description":"Include PRs where the author also reviewed. Default false. Only for metrics that list `includeSelfiePrs` in acceptedQueryParams (GET /v1/metrics; the list_metrics tool in MCP).","schema":{"default":false,"type":"boolean"}},{"name":"defaultBranchOnly","required":false,"in":"query","description":"Limit to commits/PRs on default branch only. Only for metrics that list `defaultBranchOnly` in acceptedQueryParams (GET /v1/metrics; the list_metrics tool in MCP).","schema":{"default":false,"type":"boolean"}},{"name":"excludeOrganization","required":false,"in":"query","description":"Exclude the org-level rollup series from the response. Default false.","schema":{"default":false,"type":"boolean"}},{"name":"countBy","required":false,"in":"query","description":"Unit to count by. Issue tracker metrics: issues (default) or storyPoints. GitHub feedback metrics: comments (default) or reviews. Page disruption metrics: pages (default) or disruptedHours. Only for metrics that list `countBy` in acceptedQueryParams (GET /v1/metrics; the list_metrics tool in MCP).","schema":{"enum":["issues","storyPoints","comments","reviews","pages","disruptedHours"],"type":"string"}},{"name":"direction","required":false,"in":"query","description":"Direction for feedback quality/themes metrics: 'given' (comments the team wrote) or 'received' (comments written on the team's PRs). Default given.","schema":{"default":"given","enum":["given","received"],"type":"string"}},{"name":"priorities","required":false,"in":"query","description":"Comma-separated PagerDuty priority IDs to filter by (PagerDuty metrics only). Use the priority IDs from your PagerDuty configuration.","schema":{"type":"string"}},{"name":"urgencies","required":false,"in":"query","description":"Comma-separated urgency levels to filter by (PagerDuty metrics only). Valid values: high, low.","schema":{"type":"string"}},{"name":"groupBy","required":false,"in":"query","description":"How to group the records. Defaults to team. AI metrics support: jobLevel, timezone, aiTool, nonContributors. PagerDuty metrics support: service, escalationPolicy.","schema":{"default":"team","enum":["team","service","escalationPolicy","jobLevel","timezone","aiTool","nonContributors"],"type":"string"}},{"name":"cursor","required":false,"in":"query","description":"Opaque pagination cursor from a previous response's nextCursor.","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return. Default 50, max 100.","schema":{"default":50,"type":"number"}},{"name":"metricType","required":true,"in":"path","description":"The metric to drill into.","schema":{"enum":["leadTime","codingTime","reviewWaitTime","editingTime","mergeWaitTime","deployTime","mergeFrequency","changeFailureRate","linesOfCodeChanged","filesChanged","deploymentFailureRate","commitsOutOfHours","deploymentFrequency","feedbackGiven","feedbackReceived","feedbackParticipationGap","githubFeatureVsMaintenance","aiActiveUsers","aiIntensityOfUsage","aiCohortDistribution","focusTimeGoogle","focusTimeOutlook","meetingHoursGoogle","meetingHoursOutlook","meetingHoursOohGoogle","meetingHoursOohOutlook","feedbackQuality","feedbackThemes","pagerdutyMeanTimeToRestore","pagerdutyMeanTimeToAcknowledge","pagerdutyPageDisruptions","pagerdutyPageDisruptionsOoh","pagerdutyNumberOfPages","jiraTypeOfWork","jiraFeatureVsMaintenance","linearTypeOfWork","linearFeatureVsMaintenance"],"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DrilldownResponseDto"}}}},"400":{"description":"Invalid query parameters."},"404":{"description":"Metric type not found, not available for your organization, or drilldown is not supported for it."}},"summary":"Retrieve drilldown records","tags":["customer"]}}}}
```

{% hint style="info" %}
Every chart response includes a `units` field that gives the unit of its values, such as "hours". Call `GET /v1/metrics` to see which metrics support drilldown and which optional query parameters each metric accepts.
{% endhint %}

## List AI super-users

> Returns the top AI coding tool users over the last 28 days.

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"servers":[{"url":"/"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"Authorization: Bearer <token>. A raw token in the Authorization header is also accepted for backward compatibility."}},"schemas":{}},"paths":{"/v1/super-users":{"get":{"description":"Returns the top AI coding tool users over the last 28 days.","parameters":[{"name":"teamIds","required":false,"in":"query","description":"Comma-separated team IDs to filter (mutually exclusive with teamNames, max 50).","schema":{"type":"string"}},{"name":"teamNames","required":false,"in":"query","description":"Comma-separated team names to filter (mutually exclusive with teamIds, max 50).","schema":{"type":"string"}}],"responses":{"200":{"description":"Super-user list.","content":{"application/json":{"schema":{"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicSuperUserDto"}}}}}}}},"summary":"List AI super-users","tags":["customer"]}}}}
```

## Models

## The PostDeploymentDto object

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"components":{"schemas":{"PostDeploymentDto":{"type":"object","properties":{"commitSha":{"description":"Commit SHA(s) for the deployment. Can be a single commit SHA string or an array of commit SHA strings.","oneOf":[{"type":"string","pattern":"^[A-Fa-f0-9]{7,40}$"},{"type":"array","minItems":1,"maxItems":1000,"items":{"type":"string","pattern":"^[A-Fa-f0-9]{7,40}$"}}]},"environmentName":{"type":"string","description":"The environment name the deployment occurred in.","minLength":1},"deployedAt":{"type":"string","description":"When the deployment happened (ISO8601 date-time).","format":"date-time"},"title":{"type":"string","description":"Optional title/label for the deployment.","minLength":1},"tags":{"description":"Optional tags for the deployment.","maxItems":1000,"items":{"type":"string"},"type":"array"},"isTest":{"type":"boolean","description":"If true, the deployment is treated as a test deployment and may be handled differently."}},"required":["commitSha","environmentName"]}}}}
```

## The TeamDto object

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"components":{"schemas":{"TeamDto":{"type":"object","properties":{"id":{"type":"string","description":"Team UUID."},"name":{"type":"string","description":"Team display name."},"status":{"type":"string","description":"Team status.","enum":["active","archived"]}},"required":["id","name","status"]}}}}
```

## The TeamsResponseDto object

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"components":{"schemas":{"TeamsResponseDto":{"type":"object","properties":{"items":{"description":"List of teams.","type":"array","items":{"$ref":"#/components/schemas/TeamDto"}}},"required":["items"]},"TeamDto":{"type":"object","properties":{"id":{"type":"string","description":"Team UUID."},"name":{"type":"string","description":"Team display name."},"status":{"type":"string","description":"Team status.","enum":["active","archived"]}},"required":["id","name","status"]}}}}
```

## The RepositoryDto object

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"components":{"schemas":{"RepositoryDto":{"type":"object","properties":{"name":{"type":"string","description":"Repository name without the organization, as used by the repositories filter."}},"required":["name"]}}}}
```

## The RepositoriesResponseDto object

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"components":{"schemas":{"RepositoriesResponseDto":{"type":"object","properties":{"items":{"description":"Repositories, sorted by name.","type":"array","items":{"$ref":"#/components/schemas/RepositoryDto"}}},"required":["items"]},"RepositoryDto":{"type":"object","properties":{"name":{"type":"string","description":"Repository name without the organization, as used by the repositories filter."}},"required":["name"]}}}}
```

## The MetricInfoDto object

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"components":{"schemas":{"MetricInfoDto":{"type":"object","properties":{"type":{"type":"string","description":"Metric type identifier.","enum":["leadTime","codingTime","reviewWaitTime","editingTime","mergeWaitTime","deployTime","mergeFrequency","changeFailureRate","linesOfCodeChanged","filesChanged","deploymentFailureRate","commitsOutOfHours","deploymentFrequency","feedbackGiven","feedbackReceived","feedbackParticipationGap","githubFeatureVsMaintenance","aiActiveUsers","aiIntensityOfUsage","aiCohortDistribution","focusTimeGoogle","focusTimeOutlook","meetingHoursGoogle","meetingHoursOutlook","meetingHoursOohGoogle","meetingHoursOohOutlook","feedbackQuality","feedbackThemes","pagerdutyMeanTimeToRestore","pagerdutyMeanTimeToAcknowledge","pagerdutyPageDisruptions","pagerdutyPageDisruptionsOoh","pagerdutyNumberOfPages","jiraTypeOfWork","jiraFeatureVsMaintenance","linearTypeOfWork","linearFeatureVsMaintenance"]},"description":{"type":"string","description":"Human-readable description of what this metric measures."},"acceptedQueryParams":{"description":"Optional query parameters supported by this metric, beyond the standard ones (from, to, timescale, teamIds, teamNames).","type":"array","items":{"type":"string"}},"drilldown":{"type":"boolean","description":"Whether GET /v1/charts/:metricType/drilldown is supported for this metric."},"docsUrl":{"type":"string","description":"Help center page that defines this metric. Append .md for the plain-text version."}},"required":["type","description","acceptedQueryParams","drilldown","docsUrl"]}}}}
```

## The MetricsListResponseDto object

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"components":{"schemas":{"MetricsListResponseDto":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/MetricInfoDto"}}},"required":["items"]},"MetricInfoDto":{"type":"object","properties":{"type":{"type":"string","description":"Metric type identifier.","enum":["leadTime","codingTime","reviewWaitTime","editingTime","mergeWaitTime","deployTime","mergeFrequency","changeFailureRate","linesOfCodeChanged","filesChanged","deploymentFailureRate","commitsOutOfHours","deploymentFrequency","feedbackGiven","feedbackReceived","feedbackParticipationGap","githubFeatureVsMaintenance","aiActiveUsers","aiIntensityOfUsage","aiCohortDistribution","focusTimeGoogle","focusTimeOutlook","meetingHoursGoogle","meetingHoursOutlook","meetingHoursOohGoogle","meetingHoursOohOutlook","feedbackQuality","feedbackThemes","pagerdutyMeanTimeToRestore","pagerdutyMeanTimeToAcknowledge","pagerdutyPageDisruptions","pagerdutyPageDisruptionsOoh","pagerdutyNumberOfPages","jiraTypeOfWork","jiraFeatureVsMaintenance","linearTypeOfWork","linearFeatureVsMaintenance"]},"description":{"type":"string","description":"Human-readable description of what this metric measures."},"acceptedQueryParams":{"description":"Optional query parameters supported by this metric, beyond the standard ones (from, to, timescale, teamIds, teamNames).","type":"array","items":{"type":"string"}},"drilldown":{"type":"boolean","description":"Whether GET /v1/charts/:metricType/drilldown is supported for this metric."},"docsUrl":{"type":"string","description":"Help center page that defines this metric. Append .md for the plain-text version."}},"required":["type","description","acceptedQueryParams","drilldown","docsUrl"]}}}}
```

## The ChartOptionsDto object

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"components":{"schemas":{"ChartOptionsDto":{"type":"object","properties":{"repositories":{"description":"Repository names the response was filtered to.","type":"array","items":{"type":"string"}},"excludeOrganization":{"type":"boolean","description":"Whether the org-level rollup series was excluded from the response."},"excludeWeekendHours":{"type":"boolean","description":"Whether weekend hours were excluded."},"includeSelfiePrs":{"type":"boolean","description":"Whether self-review PRs were included."},"defaultBranchOnly":{"type":"boolean","description":"Whether only default-branch commits/PRs were included."},"view":{"type":"string","description":"View that was applied.","enum":["timeSeries","aggregate"]},"direction":{"type":"string","description":"Feedback direction. Applies to feedbackQuality and feedbackThemes metrics.","enum":["given","received"]},"groupBy":{"type":"string","description":"How to group chart series. Defaults to team. AI metrics support: jobLevel, timezone, aiTool, nonContributors. PagerDuty metrics support: service, escalationPolicy. Pull request metrics support: repository.","enum":["team","service","escalationPolicy","jobLevel","timezone","aiTool","nonContributors","repository"]},"cohortMetric":{"type":"string","description":"Cohort metric used to classify users (aiCohortDistribution only). Set by the server, not a request parameter.","enum":["dailyActiveUsage","spend","inputTokens","linesChanged"]},"cohortThreshold":{"type":"number","description":"Threshold value used to split High/Low AI cohorts (aiCohortDistribution only). Unit depends on cohortMetric: percentage of active days for 'dailyActiveUsage', USD cents for 'spend', token count for 'inputTokens', line count for 'linesChanged'. Set by the server, not a request parameter."},"cohortLookbackWeeks":{"type":"number","description":"Number of lookback weeks used for cohort classification (aiCohortDistribution only). Set by the server, not a request parameter."},"individual":{"type":"boolean","description":"Whether one series per team member was returned instead of one per team.","default":false},"countBy":{"type":"string","description":"Unit that was counted by.","enum":["issues","storyPoints","comments","reviews","pages","disruptedHours"]},"priorities":{"description":"PagerDuty priority IDs the response was filtered to (PagerDuty metrics only).","type":"array","items":{"type":"string"}},"urgencies":{"type":"array","description":"Urgency levels the response was filtered to (PagerDuty metrics only).","items":{"type":"string","enum":["high","low"]}}}}}}}
```

## The DataPointDto object

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"components":{"schemas":{"DataPointDto":{"type":"object","properties":{"startDate":{"type":"string","description":"Bucket start date (ISO 8601)."},"endDate":{"type":"string","description":"Bucket end date (ISO 8601)."},"value":{"type":"number","description":"Metric value. Omitted for comment metrics (commentsGiven, commentsReceived, commentsParticipationRatio) and when percentile data (p50/p75/p90/p95) is present."},"p50":{"type":"number","description":"50th percentile value. Present when percentile data is available. Null indicates no data for this bucket.","nullable":true},"p75":{"type":"number","description":"75th percentile value. Present when percentile data is available. Null indicates no data for this bucket.","nullable":true},"p90":{"type":"number","description":"90th percentile value. Present when percentile data is available. Null indicates no data for this bucket.","nullable":true},"p95":{"type":"number","description":"95th percentile value. Present when percentile data is available. Null indicates no data for this bucket.","nullable":true},"count":{"type":"number","description":"Number of data points considered in this bucket (e.g. PRs, commits, issues). Null indicates no data for this bucket.","nullable":true},"memberCount":{"type":"number","description":"Number of people considered in this bucket (team members in scope for the data point). Null indicates no data for this bucket.","nullable":true},"spend":{"type":"number","description":"Total AI spend in USD cents for this bucket. Present for aiIntensityOfUsage.","nullable":true},"inputTokens":{"type":"number","description":"Total input tokens consumed for this bucket. Present for aiIntensityOfUsage.","nullable":true},"linesChanged":{"type":"number","description":"Total lines of code accepted for this bucket. Present for aiIntensityOfUsage.","nullable":true},"total":{"type":"number","description":"Total (sum) value for this bucket. Null indicates no data for this bucket.","nullable":true},"label":{"type":"string","description":"Category label for aggregate view data points (e.g. 'Feature', 'Bug'). Only present for githubFeatureVsMaintenance and leadTime when view=aggregate."}},"required":["startDate","endDate"]}}}}
```

## The SeriesDto object

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"components":{"schemas":{"SeriesDto":{"type":"object","properties":{"id":{"type":"string","description":"Series identifier. For team series: team UUID. For cohort series: cohort name. For repository series: repository name."},"name":{"type":"string","description":"Display name for the series."},"type":{"type":"string","description":"Series type.","enum":["team","organization","member","cohort","repository"]},"dataPoints":{"description":"Ordered list of data points for this series.","type":"array","items":{"$ref":"#/components/schemas/DataPointDto"}},"aggregateData":{"description":"The whole requested period as a single data point, with the same fields as a data point and no label: the value (or percentiles) over the entire range rather than per time bucket, and memberCount averaged across the buckets weighted by their length. Omitted for metrics where it is not available.","allOf":[{"$ref":"#/components/schemas/DataPointDto"}]}},"required":["id","name","type","dataPoints"]},"DataPointDto":{"type":"object","properties":{"startDate":{"type":"string","description":"Bucket start date (ISO 8601)."},"endDate":{"type":"string","description":"Bucket end date (ISO 8601)."},"value":{"type":"number","description":"Metric value. Omitted for comment metrics (commentsGiven, commentsReceived, commentsParticipationRatio) and when percentile data (p50/p75/p90/p95) is present."},"p50":{"type":"number","description":"50th percentile value. Present when percentile data is available. Null indicates no data for this bucket.","nullable":true},"p75":{"type":"number","description":"75th percentile value. Present when percentile data is available. Null indicates no data for this bucket.","nullable":true},"p90":{"type":"number","description":"90th percentile value. Present when percentile data is available. Null indicates no data for this bucket.","nullable":true},"p95":{"type":"number","description":"95th percentile value. Present when percentile data is available. Null indicates no data for this bucket.","nullable":true},"count":{"type":"number","description":"Number of data points considered in this bucket (e.g. PRs, commits, issues). Null indicates no data for this bucket.","nullable":true},"memberCount":{"type":"number","description":"Number of people considered in this bucket (team members in scope for the data point). Null indicates no data for this bucket.","nullable":true},"spend":{"type":"number","description":"Total AI spend in USD cents for this bucket. Present for aiIntensityOfUsage.","nullable":true},"inputTokens":{"type":"number","description":"Total input tokens consumed for this bucket. Present for aiIntensityOfUsage.","nullable":true},"linesChanged":{"type":"number","description":"Total lines of code accepted for this bucket. Present for aiIntensityOfUsage.","nullable":true},"total":{"type":"number","description":"Total (sum) value for this bucket. Null indicates no data for this bucket.","nullable":true},"label":{"type":"string","description":"Category label for aggregate view data points (e.g. 'Feature', 'Bug'). Only present for githubFeatureVsMaintenance and leadTime when view=aggregate."}},"required":["startDate","endDate"]}}}}
```

## The ChartResponseDto object

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"components":{"schemas":{"ChartResponseDto":{"type":"object","properties":{"metricType":{"type":"string","description":"Metric type identifier."},"from":{"type":"string","description":"Query start date as ISO 8601 timestamp. Absent for the githubFeatureVsMaintenance aggregate view; present for the leadTime aggregate view."},"to":{"type":"string","description":"Query end date as ISO 8601 timestamp. Absent for the githubFeatureVsMaintenance aggregate view; present for the leadTime aggregate view."},"timescale":{"type":"string","description":"Timescale used for data point bucketing. Absent for the githubFeatureVsMaintenance aggregate view; present for the leadTime aggregate view, where it has no effect because the whole period is one bucket.","enum":["daily","weekly","monthly"]},"options":{"description":"Echoes the options applied to the request, plus read-only settings the server chose.","allOf":[{"$ref":"#/components/schemas/ChartOptionsDto"}]},"series":{"description":"Chart series.","type":"array","items":{"$ref":"#/components/schemas/SeriesDto"}},"units":{"description":"Unit of measurement for this metric's values. A plain string for all metrics except aiIntensityOfUsage, which returns an object keyed by value field (spend, inputTokens, linesChanged) since that metric emits three parallel units per data point.","oneOf":[{"type":"string"},{"type":"object","additionalProperties":{"type":"string"}}]}},"required":["metricType","options","series","units"]},"ChartOptionsDto":{"type":"object","properties":{"repositories":{"description":"Repository names the response was filtered to.","type":"array","items":{"type":"string"}},"excludeOrganization":{"type":"boolean","description":"Whether the org-level rollup series was excluded from the response."},"excludeWeekendHours":{"type":"boolean","description":"Whether weekend hours were excluded."},"includeSelfiePrs":{"type":"boolean","description":"Whether self-review PRs were included."},"defaultBranchOnly":{"type":"boolean","description":"Whether only default-branch commits/PRs were included."},"view":{"type":"string","description":"View that was applied.","enum":["timeSeries","aggregate"]},"direction":{"type":"string","description":"Feedback direction. Applies to feedbackQuality and feedbackThemes metrics.","enum":["given","received"]},"groupBy":{"type":"string","description":"How to group chart series. Defaults to team. AI metrics support: jobLevel, timezone, aiTool, nonContributors. PagerDuty metrics support: service, escalationPolicy. Pull request metrics support: repository.","enum":["team","service","escalationPolicy","jobLevel","timezone","aiTool","nonContributors","repository"]},"cohortMetric":{"type":"string","description":"Cohort metric used to classify users (aiCohortDistribution only). Set by the server, not a request parameter.","enum":["dailyActiveUsage","spend","inputTokens","linesChanged"]},"cohortThreshold":{"type":"number","description":"Threshold value used to split High/Low AI cohorts (aiCohortDistribution only). Unit depends on cohortMetric: percentage of active days for 'dailyActiveUsage', USD cents for 'spend', token count for 'inputTokens', line count for 'linesChanged'. Set by the server, not a request parameter."},"cohortLookbackWeeks":{"type":"number","description":"Number of lookback weeks used for cohort classification (aiCohortDistribution only). Set by the server, not a request parameter."},"individual":{"type":"boolean","description":"Whether one series per team member was returned instead of one per team.","default":false},"countBy":{"type":"string","description":"Unit that was counted by.","enum":["issues","storyPoints","comments","reviews","pages","disruptedHours"]},"priorities":{"description":"PagerDuty priority IDs the response was filtered to (PagerDuty metrics only).","type":"array","items":{"type":"string"}},"urgencies":{"type":"array","description":"Urgency levels the response was filtered to (PagerDuty metrics only).","items":{"type":"string","enum":["high","low"]}}}},"SeriesDto":{"type":"object","properties":{"id":{"type":"string","description":"Series identifier. For team series: team UUID. For cohort series: cohort name. For repository series: repository name."},"name":{"type":"string","description":"Display name for the series."},"type":{"type":"string","description":"Series type.","enum":["team","organization","member","cohort","repository"]},"dataPoints":{"description":"Ordered list of data points for this series.","type":"array","items":{"$ref":"#/components/schemas/DataPointDto"}},"aggregateData":{"description":"The whole requested period as a single data point, with the same fields as a data point and no label: the value (or percentiles) over the entire range rather than per time bucket, and memberCount averaged across the buckets weighted by their length. Omitted for metrics where it is not available.","allOf":[{"$ref":"#/components/schemas/DataPointDto"}]}},"required":["id","name","type","dataPoints"]},"DataPointDto":{"type":"object","properties":{"startDate":{"type":"string","description":"Bucket start date (ISO 8601)."},"endDate":{"type":"string","description":"Bucket end date (ISO 8601)."},"value":{"type":"number","description":"Metric value. Omitted for comment metrics (commentsGiven, commentsReceived, commentsParticipationRatio) and when percentile data (p50/p75/p90/p95) is present."},"p50":{"type":"number","description":"50th percentile value. Present when percentile data is available. Null indicates no data for this bucket.","nullable":true},"p75":{"type":"number","description":"75th percentile value. Present when percentile data is available. Null indicates no data for this bucket.","nullable":true},"p90":{"type":"number","description":"90th percentile value. Present when percentile data is available. Null indicates no data for this bucket.","nullable":true},"p95":{"type":"number","description":"95th percentile value. Present when percentile data is available. Null indicates no data for this bucket.","nullable":true},"count":{"type":"number","description":"Number of data points considered in this bucket (e.g. PRs, commits, issues). Null indicates no data for this bucket.","nullable":true},"memberCount":{"type":"number","description":"Number of people considered in this bucket (team members in scope for the data point). Null indicates no data for this bucket.","nullable":true},"spend":{"type":"number","description":"Total AI spend in USD cents for this bucket. Present for aiIntensityOfUsage.","nullable":true},"inputTokens":{"type":"number","description":"Total input tokens consumed for this bucket. Present for aiIntensityOfUsage.","nullable":true},"linesChanged":{"type":"number","description":"Total lines of code accepted for this bucket. Present for aiIntensityOfUsage.","nullable":true},"total":{"type":"number","description":"Total (sum) value for this bucket. Null indicates no data for this bucket.","nullable":true},"label":{"type":"string","description":"Category label for aggregate view data points (e.g. 'Feature', 'Bug'). Only present for githubFeatureVsMaintenance and leadTime when view=aggregate."}},"required":["startDate","endDate"]}}}}
```

## The DrilldownResponseDto object

```json
{"openapi":"3.0.0","info":{"title":"Multitudes Customer API","version":"1.0.0"},"components":{"schemas":{"DrilldownResponseDto":{"type":"object","properties":{"metricType":{"type":"string","description":"Metric type identifier."},"options":{"description":"Echoes options that were explicitly provided in the request.","allOf":[{"$ref":"#/components/schemas/ChartOptionsDto"}]},"items":{"description":"Raw records for the current page. Shape varies by metric.","type":"array","items":{"type":"string"}},"nextCursor":{"type":"string","description":"Cursor to fetch the next page. Absent when there are no more results."}},"required":["metricType","options","items"]},"ChartOptionsDto":{"type":"object","properties":{"repositories":{"description":"Repository names the response was filtered to.","type":"array","items":{"type":"string"}},"excludeOrganization":{"type":"boolean","description":"Whether the org-level rollup series was excluded from the response."},"excludeWeekendHours":{"type":"boolean","description":"Whether weekend hours were excluded."},"includeSelfiePrs":{"type":"boolean","description":"Whether self-review PRs were included."},"defaultBranchOnly":{"type":"boolean","description":"Whether only default-branch commits/PRs were included."},"view":{"type":"string","description":"View that was applied.","enum":["timeSeries","aggregate"]},"direction":{"type":"string","description":"Feedback direction. Applies to feedbackQuality and feedbackThemes metrics.","enum":["given","received"]},"groupBy":{"type":"string","description":"How to group chart series. Defaults to team. AI metrics support: jobLevel, timezone, aiTool, nonContributors. PagerDuty metrics support: service, escalationPolicy. Pull request metrics support: repository.","enum":["team","service","escalationPolicy","jobLevel","timezone","aiTool","nonContributors","repository"]},"cohortMetric":{"type":"string","description":"Cohort metric used to classify users (aiCohortDistribution only). Set by the server, not a request parameter.","enum":["dailyActiveUsage","spend","inputTokens","linesChanged"]},"cohortThreshold":{"type":"number","description":"Threshold value used to split High/Low AI cohorts (aiCohortDistribution only). Unit depends on cohortMetric: percentage of active days for 'dailyActiveUsage', USD cents for 'spend', token count for 'inputTokens', line count for 'linesChanged'. Set by the server, not a request parameter."},"cohortLookbackWeeks":{"type":"number","description":"Number of lookback weeks used for cohort classification (aiCohortDistribution only). Set by the server, not a request parameter."},"individual":{"type":"boolean","description":"Whether one series per team member was returned instead of one per team.","default":false},"countBy":{"type":"string","description":"Unit that was counted by.","enum":["issues","storyPoints","comments","reviews","pages","disruptedHours"]},"priorities":{"description":"PagerDuty priority IDs the response was filtered to (PagerDuty metrics only).","type":"array","items":{"type":"string"}},"urgencies":{"type":"array","description":"Urgency levels the response was filtered to (PagerDuty metrics only).","items":{"type":"string","enum":["high","low"]}}}}}}}
```
