graph_categorize_mail
Replaces categories on up to 50 Outlook messages by applying master category display names, with per-message results; use an empty list to clear categories.
Instructions
Set the categories on messages, replacing the categories already set.
Each category must match the display name of a master category, so create it with graph_create_master_category first. Processes each message in order and reports per-message outcomes.
Args: message_ids: Message IDs to update (1-50 per call). categories: Category display names to apply. An empty list clears them. mailbox: Shared mailbox address or user ID to act on. Empty targets your own mailbox. Requires the delegated Mail.*.Shared permissions.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"message_ids": "<message_ids>",
"categories": "<categories>"
},
"name": "graph_categorize_mail"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mailbox | No | ||
| categories | Yes | ||
| message_ids | Yes |