skills/get-mail-search-folder/SKILL.md
# Get Mail Search Folder Retrieve the properties and relationships of a specific mail search folder by its ID. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: GET - **Path**: `/me/mailFolders/{mailFolder-id}/childFolders/{childFolder-id}` - **Operation ID**: `getMailSearchFolder` - **Tag**: MailSearchFolders - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-outl
npx skillsauth add naftiko/microsoft-outlook-sandbox skills/get-mail-search-folderInstall 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 the properties and relationships of a specific mail search folder by its ID.
/me/mailFolders/{mailFolder-id}/childFolders/{childFolder-id}getMailSearchFolderMock server URL: http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/mailFolders/{mailFolder-id}/childFolders/{childFolder-id}
Authorization: Bearer {access-token}Mail.ReadMail.ReadWrite| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| mailFolder-id | string | Yes | The unique identifier of the parent mail folder |
| childFolder-id | string | Yes | The unique identifier of the search folder |
curl -X GET "http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/mailFolders/AAMkAGI1AAAEJAAA=/childFolders/AAMkAGI1SEARCH01=" \
-H "Authorization: Bearer {access-token}"
{
"id": "AAMkAGI1SEARCH01=",
"displayName": "Unread Priority Mail",
"parentFolderId": "AAMkAGI1AAAAAA=",
"childFolderCount": 2,
"totalItemCount": 147,
"unreadItemCount": 12,
"isHidden": false,
"@odata.type": "#microsoft.graph.mailSearchFolder",
"filterQuery": "isRead eq false and importance eq 'high'",
"sourceFolderIds": ["AAMkAGI1AAAEJAAA="],
"includeNestedFolders": true,
"isSupported": true
}
Use this operation to retrieve the details of a specific mail search folder, including its filter query, source folder IDs, and whether nested folders are included. Provide both the parent folder ID and the search folder ID in the path. The response includes search-folder-specific properties like filterQuery, sourceFolderIds, includeNestedFolders, and isSupported.
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