---
title: "Changes to List messages"
method: GET
path: "/me/messages"
---

# Changes to List messages

`GET /me/messages`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 10 revisions.

- **2026-07-17** `af62694b9f2d`: 1 info
- **2026-05-28** `354d90657cdd`: 1 info
- **2026-05-28** `5c775c50414c`: 23 info
- **2026-05-28** `179a8793b938`: 1 breaking
- **2026-05-28** `c6fc1d98f528`: 1 warning, 25 info

## Changes

- **2026-07-17** `af62694b9f2d`: 1 info
  - added the optional property `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/contentBytes` to the response with the `2XX` status
- **2026-05-28** `354d90657cdd`: 1 info
  - api operation id `me.ListMessages` removed and replaced with `listMessages`
- **2026-05-28** `5c775c50414c`: 23 info
  - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2]/value/items/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.eventMessage` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/microsoft.graph.fileAttachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2]/value/items/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/microsoft.graph.fileAttachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/microsoft.graph.fileAttachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/microsoft.graph.fileAttachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.itemAttachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/microsoft.graph.mailFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[subschema #2]/value/items/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/microsoft.graph.mailFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/microsoft.graph.mailFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/microsoft.graph.mailSearchFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[subschema #2]/value/items/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/microsoft.graph.mailSearchFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/microsoft.graph.mailSearchFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `allOf[subschema #2]/value/items/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `allOf[subschema #2]/value/items/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #2: outlookItem]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/microsoft.graph.outlookItem` to `#/components/schemas/MicrosoftGraphOutlookItem` for `allOf[subschema #2]/value/items/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/microsoft.graph.outlookItem` to `#/components/schemas/MicrosoftGraphOutlookItem` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/microsoft.graph.outlookItem` to `#/components/schemas/MicrosoftGraphOutlookItem` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.referenceAttachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` response property for the response status `2XX`
- **2026-05-28** `179a8793b938`: 1 breaking
  - for the `query` request parameter `includeHiddenMessages`, the type changed from `string` to `boolean`
- **2026-05-28** `c6fc1d98f528`: 1 warning, 25 info
  - removed the optional property `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/contentBytes` from the response with the `2XX` status
  - api operation id `listMessages` removed and replaced with `me.ListMessages`
  - for the `query` request parameter `includeHiddenMessages`, the type was generalized from `boolean` to `string`
  - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `allOf[subschema #2]/value/items/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.eventMessage` changed from `#/components/schemas/MicrosoftGraphMessage` to `#/components/schemas/microsoft.graph.message` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.fileAttachment` for `allOf[subschema #2]/value/items/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.fileAttachment` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.fileAttachment` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.fileAttachment` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.itemAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailFolder` for `allOf[subschema #2]/value/items/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailFolder` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailFolder` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailSearchFolder` for `allOf[subschema #2]/value/items/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailSearchFolder` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailSearchFolder` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/MicrosoftGraphMessage` to `#/components/schemas/microsoft.graph.message` for `allOf[subschema #2]/value/items/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/MicrosoftGraphMessage` to `#/components/schemas/microsoft.graph.message` for `allOf[subschema #2]/value/items/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #2: outlookItem]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/MicrosoftGraphMessage` to `#/components/schemas/microsoft.graph.message` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/MicrosoftGraphMessage` to `#/components/schemas/microsoft.graph.message` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/MicrosoftGraphOutlookItem` to `#/components/schemas/microsoft.graph.outlookItem` for `allOf[subschema #2]/value/items/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/MicrosoftGraphOutlookItem` to `#/components/schemas/microsoft.graph.outlookItem` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/MicrosoftGraphOutlookItem` to `#/components/schemas/microsoft.graph.outlookItem` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX`
  - mapped value for discriminator key `#microsoft.graph.referenceAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `allOf[subschema #2]/value/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` response property for the response status `2XX`

---

[Operation](https://skmtc.dev/ballerina-platform/apis/microsoft-graph-mail-api/docs/me/messages/get.md) - [API](https://skmtc.dev/ballerina-platform/apis/microsoft-graph-mail-api.md) - [Page](https://skmtc.dev/ballerina-platform/apis/microsoft-graph-mail-api/changes/me/messages/get)