skills/get-copilot-usage-report/SKILL.md
# Get Copilot Usage Report Query aggregated user counts and usage data for Microsoft 365 Copilot across your organization. Use for tracking adoption and building internal reports. ## API Details - **API**: Microsoft 365 Copilot API - **Method**: GET - **Path**: `/reports/copilot/usage` - **Operation ID**: `getCopilotUsageReport` - **Tag**: Usage Reports - **OpenAPI**: [microsoft-copilot-api.yaml](../../openapi/microsoft-copilot-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/re
npx skillsauth add naftiko/microsoft-365-copilot-sandbox skills/get-copilot-usage-reportInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Query aggregated user counts and usage data for Microsoft 365 Copilot across your organization. Use for tracking adoption and building internal reports.
/reports/copilot/usagegetCopilotUsageReportMock server URL: http://localhost:8080/rest/microsoft-365-copilot-apis/1.0.0/reports/copilot/usage
Authorization: Bearer {access-token}Reports.Read.All| Parameter | In | Type | Required | Description |
|-----------|-----|------|----------|-------------|
| period | query | string | Yes | Reporting period: D7, D30, D90, or D180 |
| date | query | string (date) | No | Specific date (ISO 8601). Omit for latest data |
| $top | query | integer | No | Maximum number of results (1-999, default 25) |
| $skip | query | integer | No | Number of results to skip for pagination |
curl -X GET "http://localhost:8080/rest/microsoft-365-copilot-apis/1.0.0/reports/copilot/usage?period=D30" \
-H "Authorization: Bearer {access-token}"
{
"value": [
{
"reportDate": "2025-09-10",
"totalEnabledUsers": 5000,
"totalActiveUsers": 3250,
"wordActiveUsers": 2100,
"excelActiveUsers": 1800,
"powerPointActiveUsers": 1200,
"outlookActiveUsers": 2800,
"teamsActiveUsers": 2500,
"oneNoteActiveUsers": 600,
"loopActiveUsers": 350,
"copilotChatActiveUsers": 1900
}
],
"@odata.count": 1
}
When the user wants to view aggregated Copilot usage statistics for their organization, use this operation by making a GET request to /reports/copilot/usage. The period parameter is required and accepts D7, D30, D90, or D180. Results include user counts broken down by Microsoft 365 application.
development
# Renew or Update a Subscription Renew or update the configuration of an existing Copilot change notification subscription. ## API Details - **API**: Microsoft 365 Copilot API - **Method**: PATCH - **Path**: `/copilot/subscriptions/{subscriptionId}` - **Operation ID**: `updateCopilotSubscription` - **Tag**: Change Notifications - **OpenAPI**: [microsoft-copilot-api.yaml](../../openapi/microsoft-copilot-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-365-copilot-a
development
# Update a Package Update configuration or status of an app or agent deployed in Microsoft 365. ## API Details - **API**: Microsoft 365 Copilot API - **Method**: PATCH - **Path**: `/copilot/packages/{packageId}` - **Operation ID**: `updateCopilotPackage` - **Tag**: Packages - **OpenAPI**: [microsoft-copilot-api.yaml](../../openapi/microsoft-copilot-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-365-copilot-apis/1.0.0/copilot/packages/{packageId}` ## Required He
development
# Send a Message to Microsoft 365 Copilot Enable conversational experiences powered by Microsoft 365 Copilot. Send user messages and receive AI-generated responses grounded in Microsoft 365 data and user context. Supports multi-turn conversations. ## API Details - **API**: Microsoft 365 Copilot API - **Method**: POST - **Path**: `/copilot/chat/completions` - **Operation ID**: `createChatCompletion` - **Tag**: Chat Completions - **OpenAPI**: [microsoft-copilot-api.yaml](../../openapi/microsoft
development
# Search OneDrive Content Using Natural Language Perform hybrid search (semantic and lexical) across OneDrive for work or school content using natural language queries. Results are returned with contextual understanding and intelligent ranking while maintaining security and compliance. ## API Details - **API**: Microsoft 365 Copilot API - **Method**: POST - **Path**: `/copilot/search/query` - **Operation ID**: `querySearchContent` - **Tag**: Content Search - **OpenAPI**: [microsoft-copilot-ap