One-line summary
Similar updates
More like thisDetails
Body (from Message Center)
Updated December 12, 2025: We have updated the content and timeline. Thank you for your patience.
We’re excited to announce that Microsoft 365 Copilot usage metrics will soon be available in Microsoft Graph API v1.0, enabling organizations to programmatically access the usage data and build customized reporting and analytics for Copilot adoption.
What’s included in this release?
The metrics in Graph API v1.0 align with those in the Copilot for Microsoft 365 Usage Report in the Microsoft 365 admin center, including Tenant-level counts of enabled users and active users, Last activity date per user (Totals for each Microsoft 365 app and an overall grand total)
Please note: A few recently added metrics in the usage report are not yet available in Graph API v1.0 but will be included in a future update.
A Microsoft 365 Copilot license is required to access the Microsoft 365 Copilot usage metrics through Graph API.
This message is associated with Microsoft 365 Roadmap ID 396562 and with MC724835 Microsoft 365 admin center Usage report: Microsoft Copilot with Graph-grounded chat (Preview) (published March 2024).
[When this will happen:]
Public Preview: We will begin rolling out early September 2024 and expect to complete by mid-September 2024.
General Availability (Worldwide): We will begin rolling out mid-December 2025 (previously mid-November) and expect to complete by late December 2025 (previously mid-December).
[How this will affect your organization:]
- Before this rollout, Microsoft 365 Copilot usage metrics were available only through the Graph API Beta for testing programmatically.
- After this rollout, admins and authorized roles can use Graph API v1.0 for production scenarios to create tailored reports and analytics for Microsoft 365 Copilot. The corresponding Beta endpoints have also been updated, and a new Beta URL is available for preview and testing.
- The earlier Beta version of the Graph API will be retired on March 31, 2026, and will no longer be accessible beyond this date.
[What you need to do to prepare:]
- This rollout will happen automatically by the specified date with no admin action required before the rollout. You may want to notify your admins about this release and update any relevant documentation.
- If your organization currently uses the earlier version of Graph API Beta version for accessing the Copilot usage metrics, update your codebase to point to Graph API v1.0 as soon as possible, preferably before the aforementioned date—to ensure uninterrupted functionality.
- Review documentation at the following link: CopilotReportRoot
Raw JSON (for debugging)
Show/hide raw
{
"snapshot_item": {
"action_required_by": null,
"ai_action_required_by": "2025-12-31T00:00:00Z",
"ai_actions": [
"Notify admins about new API availability",
"Update codebase to use Graph API v1.0 for Copilot metrics",
"Review and update relevant documentation"
],
"ai_master_tags": [],
"ai_model": "gpt-4.1",
"ai_summary": "Copilot usage metrics will be available in Microsoft Graph API v1.0 for production use, enabling custom reporting and analytics; Beta API retires March 31, 2026.",
"ai_topics": [
"Copilot",
"Graph",
"Microsoft 365"
],
"category": "stayInformed",
"details_map": {
"Platforms": "Web",
"RoadmapIds": "396562",
"Summary": "Microsoft 365 Copilot usage metrics will be available in Microsoft Graph API v1.0 starting mid-December 2025, enabling programmatic access for reporting. Beta endpoints will retire March 31, 2026. No admin action is needed before rollout, but updating code from Beta to v1.0 is recommended."
},
"id": "MC877369",
"importance": 4,
"is_major_change": false,
"last_modified": "2025-12-12T18:42:40Z",
"ms_products": [
"Copilot"
],
"platforms": "Web",
"roadmap_ids": [
"396562"
],
"services": [
"Microsoft Copilot (Microsoft 365)"
],
"severity": "normal",
"tags": [
"Updated message",
"New feature",
"Admin impact"
],
"title": "(Updated) Microsoft 365 Copilot usage metrics are now available in Graph API V1.0"
}
}