---
title: "Changes to Forward message"
method: POST
path: "/me/messages/{messageId}/forward"
---

# Changes to Forward message

`POST /me/messages/{messageId}/forward`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 10 revisions.

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

## Changes

- **2026-07-17** `af62694b9f2d`: 1 info
  - added the new optional request property `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/contentBytes`
- **2026-05-28** `354d90657cdd`: 1 info
  - api operation id `me.messages.message.forward` removed and replaced with `forwardMessage`
- **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 `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.eventMessage` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/` request property
  - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/microsoft.graph.fileAttachment` to `#/components/schemas/MicrosoftGraphAttachment` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/microsoft.graph.fileAttachment` to `#/components/schemas/MicrosoftGraphAttachment` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/microsoft.graph.fileAttachment` to `#/components/schemas/MicrosoftGraphAttachment` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` request property
  - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/microsoft.graph.fileAttachment` to `#/components/schemas/MicrosoftGraphAttachment` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.itemAttachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` request property
  - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/microsoft.graph.mailFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/microsoft.graph.mailFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/microsoft.graph.mailFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/microsoft.graph.mailSearchFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/microsoft.graph.mailSearchFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/microsoft.graph.mailSearchFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #2: outlookItem]/` request property
  - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/microsoft.graph.outlookItem` to `#/components/schemas/MicrosoftGraphOutlookItem` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/microsoft.graph.outlookItem` to `#/components/schemas/MicrosoftGraphOutlookItem` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/microsoft.graph.outlookItem` to `#/components/schemas/MicrosoftGraphOutlookItem` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.referenceAttachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` request property
- **2026-05-28** `c6fc1d98f528`: 1 warning, 24 info
  - removed the request property `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/contentBytes`
  - api operation id `forwardMessage` removed and replaced with `me.messages.message.forward`
  - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.eventMessage` changed from `#/components/schemas/MicrosoftGraphMessage` to `#/components/schemas/microsoft.graph.message` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/` request property
  - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.fileAttachment` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.fileAttachment` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.fileAttachment` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` request property
  - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.fileAttachment` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.itemAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` request property
  - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailFolder` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailFolder` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailFolder` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailSearchFolder` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailSearchFolder` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailSearchFolder` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/MicrosoftGraphMessage` to `#/components/schemas/microsoft.graph.message` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/MicrosoftGraphMessage` to `#/components/schemas/microsoft.graph.message` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #2: outlookItem]/` request property
  - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/MicrosoftGraphMessage` to `#/components/schemas/microsoft.graph.message` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/MicrosoftGraphMessage` to `#/components/schemas/microsoft.graph.message` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/MicrosoftGraphOutlookItem` to `#/components/schemas/microsoft.graph.outlookItem` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/MicrosoftGraphOutlookItem` to `#/components/schemas/microsoft.graph.outlookItem` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/MicrosoftGraphOutlookItem` to `#/components/schemas/microsoft.graph.outlookItem` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property
  - mapped value for discriminator key `#microsoft.graph.referenceAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `Message/anyOf[#/components/schemas/MicrosoftGraphMessage]/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` request property

---

[Operation](https://skmtc.dev/ballerina-platform/apis/microsoft-graph-mail-api/docs/me/messages/:messageId/forward/post.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/:messageId/forward/post)