Skip to content

Commit 62b4e42

Browse files
authored
Merge pull request #28030 from mestew/copilot-report-root-note
Copilot usage reports - add note where new docs are, since under /copilot endpoint now
2 parents 08c90c0 + 2546144 commit 62b4e42

5 files changed

Lines changed: 28 additions & 5 deletions

api-reference/beta/api/reportroot-getmicrosoft365copilotusageuserdetail.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: "GGsmile"
55
ms.localizationpriority: medium
66
ms.subservice: "reports"
77
doc_type: apiPageType
8-
ms.date: 10/01/2024
8+
ms.date: 01/08/2025
99
---
1010

1111
# reportRoot: getMicrosoft365CopilotUsageUserDetail
@@ -14,6 +14,9 @@ Namespace: microsoft.graph
1414

1515
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
1616

17+
> [!NOTE]
18+
> Going forward, use the Microsoft 365 Copilot usage APIs under the `/copilot` URL path segment. For more information, see [Copilot report root](/microsoft-365-copilot/extensibility/api/admin-settings/reports/resources/copilotreportroot) and [Get Copilot usage user detail](/microsoft-365-copilot/extensibility/api/admin-settings/reports/copilotreportroot-getmicrosoft365copilotusageuserdetail).
19+
1720
Get the most recent activity data for enabled users of Microsoft 365 Copilot apps.
1821

1922
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]

api-reference/beta/api/reportroot-getmicrosoft365copilotusercountsummary.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: "GGsmile"
55
ms.localizationpriority: medium
66
ms.subservice: "reports"
77
doc_type: apiPageType
8-
ms.date: 10/01/2024
8+
ms.date: 01/08/2025
99
---
1010

1111
# reportRoot: getMicrosoft365CopilotUserCountSummary
@@ -14,6 +14,9 @@ Namespace: microsoft.graph
1414

1515
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
1616

17+
> [!NOTE]
18+
> Going forward, use the Microsoft 365 Copilot usage APIs under the `/copilot` URL path segment. For more information, see [Copilot report root](/microsoft-365-copilot/extensibility/api/admin-settings/reports/resources/copilotreportroot) and [Get Copilot user count summary](/microsoft-365-copilot/extensibility/api/admin-settings/reports/copilotreportroot-getmicrosoft365copilotusercountsummary).
19+
1720
Get the aggregated number of active and enabled users of Microsoft 365 Copilot for a specified time period.
1821

1922
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]

api-reference/beta/api/reportroot-getmicrosoft365copilotusercounttrend.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: "GGsmile"
55
ms.localizationpriority: medium
66
ms.subservice: "reports"
77
doc_type: apiPageType
8-
ms.date: 10/01/2024
8+
ms.date: 01/08/2025
99
---
1010

1111
# reportRoot: getMicrosoft365CopilotUserCountTrend
@@ -14,6 +14,9 @@ Namespace: microsoft.graph
1414

1515
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
1616

17+
> [!NOTE]
18+
> Going forward, use the Microsoft 365 Copilot usage APIs under the `/copilot` URL path segment. For more information, see [Copilot report root](/microsoft-365-copilot/extensibility/api/admin-settings/reports/resources/copilotreportroot) and [Get Copilot user count trend](/microsoft-365-copilot/extensibility/api/admin-settings/reports/copilotreportroot-getmicrosoft365copilotusercounttrend).
19+
1720
Get the trend in the daily number of active and enabled users of Microsoft 365 Copilot for a specified time period.
1821

1922
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]

api-reference/beta/resources/reportroot.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: "egreenberg14"
55
ms.localizationpriority: medium
66
ms.subservice: "entra-monitoring-health"
77
doc_type: resourcePageType
8-
ms.date: 10/24/2024
8+
ms.date: 01/08/2025
99
---
1010

1111
# reportRoot resource type
@@ -20,7 +20,11 @@ Represents a container for Microsoft Entra ID and Microsoft 365 reporting resour
2020

2121
### Microsoft 365 Copilot usage
2222

23-
For details about report views and names, see [Microsoft 365 reports - Microsoft 365 Copilot usage](/microsoft-365/admin/activity-reports/microsoft-365-copilot-usage).
23+
For details about report views and names, see [Microsoft 365 reports - Microsoft 365 Copilot usage](/microsoft-365/admin/activity-reports/microsoft-365-copilot-usage).
24+
25+
> [!NOTE]
26+
> Going forward, use the Microsoft 365 Copilot usage APIs under the `/copilot` URL path segment. For more information, see [Copilot report root](/microsoft-365-copilot/extensibility/api/admin-settings/reports/resources/copilotreportroot).
27+
2428

2529
| Method | Return type | Description |
2630
| :------------------------------------------------------------------------------------- | :---------- | :------------------------------------------------------------------------------------------------------------- |

concepts/whats-new-overview.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,16 @@ For details about previous updates to Microsoft Graph, see [Microsoft Graph what
1818
> [!IMPORTANT]
1919
> Features in _preview_ status are subject to change without notice, and might not be promoted to generally available (GA) status. Don't use preview features in production apps.
2020
21+
## January 2026: New and generally available
22+
23+
### Reports | Microsoft 365 usage reports
24+
25+
Going forward, use the Microsoft 365 Copilot usage APIs under the `/copilot` URL path segment. For more information, see:
26+
- [Copilot report root](/microsoft-365-copilot/extensibility/api/admin-settings/reports/resources/copilotreportroot)
27+
- [Get Copilot user count summary](/microsoft-365-copilot/extensibility/api/admin-settings/reports/copilotreportroot-getmicrosoft365copilotusercountsummary)
28+
- [Get Copilot user count trend](/microsoft-365-copilot/extensibility/api/admin-settings/reports/copilotreportroot-getmicrosoft365copilotusercounttrend)
29+
- [Get Copilot usage user detail](/microsoft-365-copilot/extensibility/api/admin-settings/reports/copilotreportroot-getmicrosoft365copilotusageuserdetail)
30+
2131
## December 2025: New and generally available
2232

2333
### Calendars | Places

0 commit comments

Comments
 (0)