skills.rest
naftiko
naftikoOFFICIAL
Explore all skills by this author →
WebsiteGitHub

Update Mail Search Folder

Update mail search folder properties via Microsoft Graph API PATCH requests.

Updated Aug 27, 2026
Search Tags:#api#update#filter#outlook#mail#search folder
One-click install
npx skills add https://github.com/naftiko/microsoft-outlook-sandbox --skill update-mail-search-folder
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Update Mail Search Folder
Source: https://github.com/naftiko/microsoft-outlook-sandbox/tree/main/skills/update-mail-search-folder
Command: npx skills add https://github.com/naftiko/microsoft-outlook-sandbox --skill update-mail-search-folder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill allows users to modify existing mail search folders, enabling them to precisely control which emails are included in these dynamic views.

Core Features & Use Cases

  • Update Search Criteria: Change the filterQuery to adjust the conditions for matching emails.
  • Modify Scope: Update sourceFolderIds to include or exclude specific parent folders from the search.
  • Rename Folder: Change the displayName of the search folder for better organization.
  • Use Case: A user wants to update a "High Priority Unread" search folder to also include emails from a newly added project folder, and refine the filter to only show emails marked as 'important'.

Quick Start

Use the Update Mail Search Folder skill to change the filter query for the search folder with ID 'AAMkAGI1SEARCH01=' to 'isRead eq false'.

Frequently Asked Questions about Update Mail Search Folder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update the filter query in an Outlook mail search folder?▼

To update a mail search folder filter query, use the Update Mail Search Folder skill to send a PATCH request to the Microsoft Graph API. This modifies the filterQuery property to adjust the conditions for matching emails within the specified Outlook folder.

Can I change the source folders for an existing Outlook search folder?▼

Yes, you can change the source folders for an existing Outlook search folder by modifying the sourceFolderIds property. This PATCH request to the Microsoft Graph API includes or excludes specific parent folders from the search scope.

How do I rename a mail search folder in Microsoft Outlook via Graph API?▼

You can rename a mail search folder in Microsoft Outlook via the Graph API by using a PATCH request to update the displayName property. This modifies the folder name for better organization within the mailbox.

Does the Microsoft Graph API support modifying nested folder inclusion for mail search folders?▼

Yes, the Microsoft Graph API supports modifying nested folder inclusion for mail search folders. The Update Mail Search Folder skill allows you to adjust the nested folder inclusion settings alongside updating display name and filter criteria.

What is the best way to refine Outlook search folder criteria without recreating the folder?▼

The best way to refine Outlook search folder criteria without recreating the folder is sending a PATCH request to the Microsoft Graph API. This directly updates properties like filterQuery and sourceFolderIds on the existing search folder.

Related Skills

Explore More Software Engineering Skills→
bennoloefflerbennoloeffler
2

bel-move-mail-to-archive

Move a single Microsoft 365 email message to the Archive folder.

Community
Intermediate
d-oitd-oit
13

web-search-patterns

Structure web-search queries with boolean operators and domain filters.

Community
Basic
AceDataCloudAceDataCloud
13

microsoft-outlook

Manage Outlook mail and calendar via Microsoft Graph with OAuth tokens.

Official
Advanced
dsactivi-2dsactivi-2

outlook

Manage Outlook emails, calendar events, and contacts via Microsoft Graph.

Community
Advanced