skills/update-subscription/SKILL.md
# 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
npx skillsauth add naftiko/microsoft-365-copilot-sandbox skills/update-subscriptionInstall 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.
Renew or update the configuration of an existing Copilot change notification subscription.
/copilot/subscriptions/{subscriptionId}updateCopilotSubscriptionMock server URL: http://localhost:8080/rest/microsoft-365-copilot-apis/1.0.0/copilot/subscriptions/{subscriptionId}
Authorization: Bearer {access-token}Content-Type: application/jsonCopilot.ChangeNotification.ReadWrite| Parameter | In | Type | Required | Description |
|-----------|-----|------|----------|-------------|
| subscriptionId | path | string | Yes | Unique identifier of the subscription |
{
"expirationDateTime": "2025-11-15T00:00:00Z"
}
| Field | Type | Required | Description |
|-------|------|----------|-------------|
| expirationDateTime | string | No | New expiration date/time (ISO 8601) |
| notificationUrl | string | No | Updated webhook URL |
curl -X PATCH "http://localhost:8080/rest/microsoft-365-copilot-apis/1.0.0/copilot/subscriptions/sub-001-abc" \
-H "Authorization: Bearer {access-token}" \
-H "Content-Type: application/json" \
-d '{"expirationDateTime": "2025-11-15T00:00:00Z"}'
{
"id": "sub-001-abc",
"resource": "/copilot/interactions",
"changeType": "created",
"notificationUrl": "https://contoso.com/webhooks/copilot-notifications",
"expirationDateTime": "2025-11-15T00:00:00Z",
"clientState": "contoso-secret-state-value",
"createdDateTime": "2025-09-10T12:00:00Z"
}
When the user wants to renew or update an existing change notification subscription (e.g., extend expiration or change webhook URL), use this operation by making a PATCH request to /copilot/subscriptions/{subscriptionId}. Provide the subscription ID and the fields to update.
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
development
# Retrieve Relevant Content from Microsoft 365 Retrieve contextually relevant information from Microsoft 365 content (documents, policies, knowledge bases) while respecting document access controls and sensitivity labels. Useful for building specialized assistants grounded in organizational data. ## API Details - **API**: Microsoft 365 Copilot API - **Method**: POST - **Path**: `/copilot/retrieval/query` - **Operation ID**: `queryRetrievalContent` - **Tag**: Content Retrieval - **OpenAPI**: [