skills/get-subscription/SKILL.md
# Get Subscription Retrieve a specific webhook subscription by its identifier. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: GET - **Path**: `/subscriptions/{subscription-id}` - **Operation ID**: `getSubscription` - **Tag**: Subscriptions - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/subscriptions/{subscription-id}` ## Required Head
npx skillsauth add naftiko/microsoft-outlook-sandbox skills/get-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.
Retrieve a specific webhook subscription by its identifier.
/subscriptions/{subscription-id}getSubscriptionMock server URL: http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/subscriptions/{subscription-id}
Authorization: Bearer {access-token}Mail.Read| Parameter | In | Type | Required | Description | |-----------|-----|------|----------|-------------| | subscription-id | path | string | Yes | The unique identifier of the subscription |
curl -X GET "http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/subscriptions/7f105c7d-2dc5-4530-97cd-4e7ae6534c07" \
-H "Authorization: Bearer {access-token}"
{
"id": "7f105c7d-2dc5-4530-97cd-4e7ae6534c07",
"resource": "me/mailFolders('Inbox')/messages",
"changeType": "created,updated",
"notificationUrl": "https://webhook.contoso.com/api/notifications",
"expirationDateTime": "2024-02-15T11:00:00Z"
}
Use this operation to retrieve the details of a specific webhook subscription by providing its unique identifier in the URL path. The response includes the subscription's resource, change types, notification URL, and expiration date. This is useful for checking subscription status and expiration.
tools
# Update Open Extension Update an existing open type extension on a message. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: PATCH - **Path**: `/me/messages/{message-id}/extensions/{extension-id}` - **Operation ID**: `updateOpenExtension` - **Tag**: Extensions - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/messages/{message-id}/exten
development
# Update Message Updates the properties of an existing message in the signed-in user's mailbox, such as marking it as read or changing its importance. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: PATCH - **Path**: `/me/messages/{message-id}` - **Operation ID**: `updateMessage` - **Tag**: Messages - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-outlook-mail-
development
# Update Inbox Rule Update the properties of an existing inbox message rule. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: PATCH - **Path**: `/me/mailFolders/inbox/messageRules/{messageRule-id}` - **Operation ID**: `updateMessageRule` - **Tag**: InboxRules - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/mailFolders/inbox/messageRule
development
# Update Mailbox Settings Update the user's mailbox settings such as automatic replies, locale, time zone, or working hours. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: PATCH - **Path**: `/me/mailboxSettings` - **Operation ID**: `updateMailboxSettings` - **Tag**: MailboxSettings - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/mail