Microsoft Graph: Microsoft 365 Copilot
Microsoft 365 Copilot APIs in v1.0: the Retrieval API (grounding answers in SharePoint, OneDrive and connector content), Copilot interaction history, usage…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Microsoft 365 Copilot APIs in v1.0: the Retrieval API (grounding answers in SharePoint, OneDrive and connector content), Copilot interaction history, usage reports and admin settings.
This listing is one area of Microsoft Graph, the single REST API for Microsoft 365, Outlook, OneDrive, Teams and Microsoft Entra ID. It holds 49 of the area's requests, the most direct ones first, generated from Microsoft's own OpenAPI description of Graph v1.0. The other areas (mail, calendar, files, Teams, users and more) are listed separately on the Microsoft page.
Get an access token
- Sign in to the Microsoft Entra admin center and open App registrations > New registration. For a quick test, the Graph Explorer signs you in and shows a token without registering anything.
- Under API permissions, add the Microsoft Graph permissions this area needs, for example:
depends on the operation. Delegated permissions act as the signed-in user; application permissions act as the app itself and need an administrator's consent. - Under Certificates & secrets, create a client secret (keep it out of shared collections).
- Get a token from
https://login.microsoftonline.com/ /oauth2/v2.0/token: the authorization-code flow for a user, orgrant_type=client_credentialswithscope=https://graph.microsoft.com/.defaultfor an app. Send it asAuthorization: Bearer.
Using these requests
- Base URL:
https://graph.microsoft.com/v1.0./me/...paths act on the signed-in user; with an application token use/users/{id or userPrincipalName}/...instead. - Shape responses with OData query parameters:
$select(fields),$filter,$orderby,$top,$expandand$search(some need theConsistencyLevel: eventualheader). Long lists are paged: follow@odata.nextLink. - Combine up to 20 requests in one call with
POST /$batch.
Common errors
| Status | Code | What to do |
|---|---|---|
| 401 | InvalidAuthenticationToken | The token is missing, expired or for another resource: get a new one for https://graph.microsoft.com. |
| 403 | Authorization_RequestDenied / ErrorAccessDenied | Add the permission listed in the request's docs and grant consent. |
| 404 | ResourceNotFound / itemNotFound | Check the id; ids from another user or tenant are not found. |
| 429 | TooManyRequests | Throttled: wait the Retry-After seconds, then retry. |
Docs: Microsoft 365 Copilot overview · Permissions reference · Throttling
Endpoints 49
Copilot
- GETGet copilot
/copilot - PATCHUpdate copilot
/copilot - POSTCreate retrieval
/copilot/retrievalDeprecated.
Copilot: admin
- GETGet admin
/copilot/admin - DELETEDelete admin
/copilot/admin - PATCHUpdate admin
/copilot/admin - GETGet catalog
/copilot/admin/catalog - DELETEDelete catalog
/copilot/admin/catalog - PATCHUpdate catalog
/copilot/admin/catalog - GETGet settings
/copilot/admin/settings - DELETEDelete settings
/copilot/admin/settings - PATCHUpdate settings
/copilot/admin/settings - GETList packages
/copilot/admin/catalog/packages - GETGet limited mode
/copilot/admin/settings/limitedMode - DELETEDelete limited mode
/copilot/admin/settings/limitedMode - PATCHUpdate limited mode
/copilot/admin/settings/limitedMode - GETGet package
/copilot/admin/catalog/packages/:copilotPackageDetail-id - GETGet zip file
/copilot/admin/catalog/packages/:copilotPackageDetail-id/zipFile - PUTReplace zip file
/copilot/admin/catalog/packages/:copilotPackageDetail-id/zipFile - DELETEDelete zip file
/copilot/admin/catalog/packages/:copilotPackageDetail-id/zipFile
Copilot: users
- GETList users
/copilot/users - POSTCreate user
/copilot/users - GETGet user
/copilot/users/:aiUser-id - DELETEDelete user
/copilot/users/:aiUser-id - PATCHUpdate user
/copilot/users/:aiUser-id - GETList online meetings
/copilot/users/:aiUser-id/onlineMeetings - POSTCreate online meeting
/copilot/users/:aiUser-id/onlineMeetings - GETGet interaction history
/copilot/users/:aiUser-id/interactionHistory - DELETEDelete interaction history
/copilot/users/:aiUser-id/interactionHistory - PATCHUpdate interaction history
/copilot/users/:aiUser-id/interactionHistory - GETGet online meeting
/copilot/users/:aiUser-id/onlineMeetings/:aiOnlineMeeting-id - DELETEDelete online meeting
/copilot/users/:aiUser-id/onlineMeetings/:aiOnlineMeeting-id - PATCHUpdate online meeting
/copilot/users/:aiUser-id/onlineMeetings/:aiOnlineMeeting-id - GETGet all enterprise interactions (interaction history)
/copilot/users/:aiUser-id/interactionHistory/getAllEnterpriseInteractions() - GETList ai insights
/copilot/users/:aiUser-id/onlineMeetings/:aiOnlineMeeting-id/aiInsights - POSTCreate ai insight
/copilot/users/:aiUser-id/onlineMeetings/:aiOnlineMeeting-id/aiInsights - GETGet ai insight
/copilot/users/:aiUser-id/onlineMeetings/:aiOnlineMeeting-id/aiInsights/:callAiInsight-id - DELETEDelete ai insight
/copilot/users/:aiUser-id/onlineMeetings/:aiOnlineMeeting-id/aiInsights/:callAiInsight-id - PATCHUpdate ai insight
/copilot/users/:aiUser-id/onlineMeetings/:aiOnlineMeeting-id/aiInsights/:callAiInsight-id
Copilot: reports
- GETList reports
/copilot/reports - DELETEDelete reports
/copilot/reports - PATCHUpdate reports
/copilot/reports - GETGet report
/copilot/reports/getMicrosoft365CopilotUserCountTrend(period=':period',version='@version') - GETGet report
/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period=':period',version='@version') - GETGet report
/copilot/reports/getMicrosoft365CopilotUserCountSummary(period=':period',version='@version')
Copilot: interaction history
- GETGet interaction history
/copilot/interactionHistory - DELETEDelete interaction history
/copilot/interactionHistory - PATCHUpdate interaction history
/copilot/interactionHistory - GETGet all enterprise interactions (interaction history)
/copilot/interactionHistory/getAllEnterpriseInteractions()
API details
- Base URL
https://graph.microsoft.com/v1.0- Authentication
- OAuth 2.0 (authorization code, client credentials flows)
- Operations
- 49 operations on 23 pathsGET 22PATCH 11DELETE 11POST 4PUT 1
1 marked deprecated - Main resources
- Copilot: users 19Copilot: admin 17Copilot: reports 6Copilot: interaction history 4Copilot 3
- Description format
- OpenAPI 3.0.4, API version
v1.0 - Links
- Documentation · OpenAPI document
How to test the Microsoft Graph: Microsoft 365 Copilot in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Microsoft Graph: Microsoft 365 Copilot collection, without the publisher's secrets.
- Add your credentialsThis API uses OAuth 2.0 (authorization code, client credentials flows). Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Get copilot” (GET /copilot), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Microsoft Graph: Microsoft 365 Copilot?
Microsoft 365 Copilot APIs in v1.0: the Retrieval API (grounding answers in SharePoint, OneDrive and connector content), Copilot interaction history, usage… It is listed under AI & machine learning and has 49 endpoints.
Who publishes the Microsoft Graph: Microsoft 365 Copilot?
It is listed from Microsoft's public API description (an OpenAPI document), not published by Microsoft on Swastik Codes. Anyone who controls microsoft.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Microsoft Graph: Microsoft 365 Copilot?
Requests go to https://graph.microsoft.com/v1.0. Endpoint paths are added to this base URL.
How do I authenticate with the Microsoft Graph: Microsoft 365 Copilot?
With OAuth 2.0 (authorization code, client credentials flows).
How many endpoints does the Microsoft Graph: Microsoft 365 Copilot have?
49 operations on 23 paths (22 GET, 11 PATCH, 11 DELETE, 4 POST, 1 PUT). The largest groups are Copilot: users, Copilot: admin, Copilot: reports, Copilot: interaction history.
Is forking the Microsoft Graph: Microsoft 365 Copilot free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.