skills/update-message/SKILL.md
# 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-
npx skillsauth add naftiko/microsoft-outlook-sandbox skills/update-messageInstall 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.
Updates the properties of an existing message in the signed-in user's mailbox, such as marking it as read or changing its importance.
/me/messages/{message-id}updateMessageMock server URL: http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/messages/{message-id}
Authorization: Bearer {access-token}Content-Type: application/jsonMail.ReadWrite| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| message-id | string | Yes | The unique identifier of the message |
Provide only the properties you want to update:
| Property | Type | Description |
|----------|------|-------------|
| subject | string | The subject of the message |
| body | object | The body with contentType and content |
| isRead | boolean | Whether the message has been read |
| importance | string | The importance: low, normal, high |
| categories | array | Array of category strings |
curl -X PATCH "http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/messages/AAMkAGI1AAAGB1rUAAA=" \
-H "Authorization: Bearer {access-token}" \
-H "Content-Type: application/json" \
-d '{
"isRead": true,
"importance": "high"
}'
{
"id": "AAMkAGI1AAAGB1rUAAA=",
"subject": "Quarterly Review Meeting",
"bodyPreview": "Please join us for the quarterly review...",
"body": {"contentType": "html", "content": "<html><body>Please join us for the quarterly review...</body></html>"},
"importance": "high",
"isRead": true,
"isDraft": false,
"hasAttachments": false,
"from": {"emailAddress": {"name": "Alex Wilber", "address": "[email protected]"}},
"toRecipients": [{"emailAddress": {"name": "Megan Bowen", "address": "[email protected]"}}],
"createdDateTime": "2024-01-15T10:30:00Z",
"receivedDateTime": "2024-01-15T10:30:00Z",
"parentFolderId": "AAMkAGI1AAAEJAAA="
}
Use this operation to modify properties of an existing message. Common uses include marking a message as read or unread, changing its importance level, updating categories, or modifying the content of a draft message. Only include the properties you want to change in the request body. The response returns the full updated message object. This operation works on both received messages and drafts.
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 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
development
# Update Mail Search Folder Update the properties of a specific mail search folder, such as its filter query or source folders. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: PATCH - **Path**: `/me/mailFolders/{mailFolder-id}/childFolders/{childFolder-id}` - **Operation ID**: `updateMailSearchFolder` - **Tag**: MailSearchFolders - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:80