apply-category
Set, add, or remove category labels on Outlook email messages. Use message ID or batch IDs to replace, append, or remove categories by display name.
Instructions
Tag or untag email messages with master categories (those created via manage-category). action=set (default) replaces the message's category set with the supplied categories array. action=add appends categories to whatever's already on the message. action=remove removes only the named categories, leaving the rest. Accepts either messageId (single) or messageIds (batch via Graph $batch). categories are matched by display name — names must already exist in the master list (create via manage-category first). Returns per-message confirmation.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| messageId | No | Single message ID to categorise | |
| messageIds | No | Array of message IDs to categorise (batch operation) | |
| categories | Yes | Category display names to apply/remove (required) | |
| action | No | set (replace all), add (append), remove (remove specific). Default: set |