Skip to content

Copilot usage API: Microsoft 365 Copilot

Idun Cockpit reads your licensed users’ Microsoft 365 Copilot exchanges through the Microsoft Graph API, with an app your administrator registers in Microsoft Entra. This is Microsoft 365 Copilot, the office-suite assistant, not GitHub Copilot. For seats and renewal, see Microsoft 365 Copilot for business; for what the usage report leaves out, the dedicated article.

Microsoft Graph API What it returns Permission
Interaction history (getAllEnterpriseInteractions) Each user’s requests and responses, in Teams, Word, Outlook and Copilot Chat. AiEnterpriseInteraction.Read.All, application
Usage report (getMicrosoft365CopilotUsageUserDetail) Counters per user: last activity per app, number of requests. No content. Reports.Read.All

The Cockpit reads the interaction history: the content of the exchanges is what reveals the use cases. The usage report counts activity; it says a licence is active, not what it is used for.

  • A Microsoft 365 tenant with Microsoft 365 Copilot licences.
  • A Microsoft Entra administrator allowed to grant consent for the whole organization.
  1. Register an app

    In the Microsoft Entra admin center, open “App registrations”, then “New registration”. Name the app and choose a single tenant.

  2. Add the permission

    Under “API permissions”, add a Microsoft Graph application permission: AiEnterpriseInteraction.Read.All. There is no delegated mode for this permission.

  3. Grant consent

    Click “Grant admin consent” for your organization, then check that the permission’s status shows it is granted.

  4. Create a secret and send it to us

    Under “Certificates & secrets”, create a client secret. Send the tenant ID, the app ID and the secret through the channel agreed at the start of the audit, never by email.

  • Measured: each licensed user’s requests and responses, the app where they happened, the date.
  • Not covered by this API: agents built with Copilot Studio, and Copilot Chat without a Microsoft 365 Copilot licence.
  • Not available: the model used and the cost per exchange; Microsoft does not provide them.

Isn’t the admin center’s usage report enough?

Section titled “Isn’t the admin center’s usage report enough?”

It counts active licences: a licence becomes active from the first request. It says neither for which tasks nor with what return. The Cockpit starts from the exchanges to answer both questions.

No. The application permission covers the whole tenant once consent is granted.

To see what the tool shows on your own tools, book a call.