skills/get-message/SKILL.md
# Get Message Retrieves a specific message from the signed-in user's mailbox by its unique identifier. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: GET - **Path**: `/me/messages/{message-id}` - **Operation ID**: `getMessage` - **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-api/1.0.0/me/messages/{message-id}` ## Required Head
npx skillsauth add naftiko/microsoft-outlook-sandbox skills/get-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.
Retrieves a specific message from the signed-in user's mailbox by its unique identifier.
/me/messages/{message-id}getMessageMock server URL: http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/messages/{message-id}
Authorization: Bearer {access-token}Mail.ReadMail.ReadWrite| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| message-id | string | Yes | The unique identifier of the message |
| Parameter | Type | Description |
|-----------|------|-------------|
| $select | string | Comma-separated list of properties to include |
curl -X GET "http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/messages/AAMkAGI1AAAGB1rUAAA=?$select=subject,body,from,toRecipients" \
-H "Authorization: Bearer {access-token}"
{
"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": "normal",
"isRead": false,
"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 retrieve the full details of a specific message when you have its ID. Use $select to limit the properties returned if you only need specific fields, which improves performance. This is commonly used after listing messages to get the full body content of a particular message, or when processing a message ID received from a notification or other operation.
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