Skip to content

Commit 76805f5

Browse files
sgrayCopilotsubatoi
authored
Update Copilot usage report docs for NDJSON downloads (#61488)
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Ben Ahmady <32935794+subatoi@users.noreply.github.com>
1 parent 617d51b commit 76805f5

2 files changed

Lines changed: 4 additions & 4 deletions

File tree

content/copilot/reference/copilot-usage-metrics/team-level-metrics.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ The same join recipe supports any team-level slice you need: per `(team, day)`,
1919

2020
## Fetching the reports
2121

22-
The two reports referenced in this guide are downloaded in two steps. First, call the REST endpoint for the day you want. The endpoint returns time-limited signed URLs from which you can download the report files. Then download the JSON files those URLs point to. The user-team and per-user rows are in those JSON files; they are not returned inline by the REST endpoint.
22+
The two reports referenced in this guide are downloaded in two steps. First, call the REST endpoint for the day you want. The endpoint returns time-limited signed URLs from which you can download the report files. Then download the newline-delimited JSON (NDJSON) files those URLs point to. The user-teams and per-user rows are in those NDJSON files; they are not returned inline by the REST endpoint.
2323

2424
| Report | Endpoint |
2525
|:--|:--|
@@ -33,7 +33,7 @@ Each endpoint returns a response of the form:
3333
```json
3434
{
3535
"download_links": [
36-
"https://example.com/copilot-user-teams-report-1.json"
36+
"https://example.com/copilot-user-teams-report-1.ndjson"
3737
],
3838
"report_day": "2026-05-07"
3939
}
@@ -89,7 +89,7 @@ The entity-level reports (`enterprise_28_day`, `organization_28_day`, `enterpris
8989

9090
## Example
9191

92-
This minimal end-to-end example produces one day of organization-team metrics. The JSON shown below for each input report is a sample of the rows you would find in the file downloaded from one of that report's `download_links` (see [Fetching the reports](#fetching-the-reports) above).
92+
This minimal end-to-end example produces one day of organization-team metrics. The sample NDJSON rows below for each input report are like the rows you would find in the file downloaded from one of that report's `download_links` (see [Fetching the reports](#fetching-the-reports) above).
9393

9494
Two users have {% data variables.product.prodname_copilot_short %} activity on 2026-05-07 in organization `999`:
9595

content/copilot/tutorials/roll-out-at-scale/measure-success.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -100,7 +100,7 @@ Example response:
100100
```json
101101
{
102102
"download_links": [
103-
"https://example.com/copilot-usage-report.json"
103+
"https://example.com/copilot-usage-report.ndjson"
104104
],
105105
"report_start_day": "2025-07-18",
106106
"report_end_day": "2025-08-14"

0 commit comments

Comments
 (0)