04 September 2026

Graph Copilot usage API — fuel for the Steward pane

MRC 396562 launched Copilot usage into Microsoft Graph (#copilotcontrolsystem). Learn APIs for licensed-user activity — measure value, then reclaim.

microsoftcopilotgraphfinopsccsroadmap

DIGITAL SKILL WORKS LTD / 12 PANES

Graph Copilot usage API — fuel for the Steward pane

Editorial illustration: usage chart with a red trend line and steward ledger

Illustration: Paper/Ink header (AI-assisted). DIGITAL SKILL WORKS LTD / 12 PANES.

If you cannot see licensed activity, you cannot run Use it or lose it. Graph reporting turns admin-centre metrics into Steward workflows.

What shipped / what’s on the roadmap

Graph API — Copilot for Microsoft 365 usage (MRC 396562) — status Launched. Copilot usage added to Microsoft Graph for customised reporting and analytics. Metrics match the Microsoft 365 admin centre Copilot usage report: tenant-level enabled and active users, and last activity date per user (overall and per Microsoft 365 app). Tagged #copilotcontrolsystem. Preview September 2024 / GA November 2025 on the item — verify live.

What Learn says

copilotReportRoot: getMicrosoft365CopilotUsageUserDetail returns recent usage for users enabled for Microsoft 365 Copilot apps. Periods such as D7/D30 (v1) or D7/D28 (v2) aggregate windows. Version 2 adds prompt counts, active usage days, Copilot Chat work/web last activity, Edge, and Copilot Agent last activity. Licensed users only — unlicensed Copilot Chat usage is not in these Graph reports; use admin centre Copilot Chat usage, Purview audit, or Management Activity API exports instead. Requires Reports.Read.All and an appropriate Entra limited admin role for delegated calls.

Why you should care (12 Panes)

Board. Evidence for value, not vanity dashboards.

CFO / Steward. Reconcile activity to the frozen value case; reclaim dormant seats.

CISO. Reporting permissions are privileged — least privilege for Reports Reader / AI Admin.

Adoption. Coach from patterns; do not weaponise last-activity dates without context.

Panes. 06 Cost & Value · 07 Licence · 08 Adoption · CCS measurement pillar.

Diagram

Diagram: enabled users to Graph reports API to per-app last activity to frozen value case to reclaim/coach

Diagram: 12 Panes / tldraw — board “12 Panes — Blog Diagrams”.

Suggested action

  1. Pipe getMicrosoft365CopilotUsageUserDetail (v2 where available) into your FinOps workbook.
  2. Define dormant thresholds with Adoption — not Security alone.
  3. Separate licensed Copilot metrics from unlicensed Chat metrics in board packs.
  4. Review monthly under CCS measurement and reporting with Steward and Pulse.

Communication needed

FinOps + Adoption: reclaim vs coach narrative. Security: who may read reports. Comms: transparency with staff about measurement purpose.

Benefits and risks

Benefits. Programmatic Use it or lose it. Per-app signal for clinics. CCS-aligned measurement.

Risks. Incomplete picture if Chat-only usage is ignored. Surveillance culture if metrics are used punitively. Beta Graph paths changing under production jobs.

Sources

Back to blog