skills/list-categories/SKILL.md
# List All Categories List all Outlook categories defined for the user's mailbox. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: GET - **Path**: `/me/outlook/masterCategories` - **Operation ID**: `listCategories` - **Tag**: Categories - **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/outlook/masterCategories` ## Required Headers - `A
npx skillsauth add naftiko/microsoft-outlook-sandbox skills/list-categoriesInstall 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.
List all Outlook categories defined for the user's mailbox.
/me/outlook/masterCategorieslistCategoriesMock server URL: http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/outlook/masterCategories
Authorization: Bearer {access-token}MailboxSettings.ReadWriteNo required parameters.
curl -X GET "http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/outlook/masterCategories" \
-H "Authorization: Bearer {access-token}"
{
"value": [
{
"id": "afc97c36-af15-4e96-bf52-e228c84d4567",
"displayName": "Blue Category",
"color": "preset7"
}
]
}
Use this operation to retrieve all master categories configured in the user's mailbox. Categories can be applied to messages, events, and other Outlook items to help organize them. The response includes each category's display name, color preset, and unique identifier.
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