title | description | author | ms.localizationpriority | ms.subservice | doc_type |
---|---|---|---|---|---|
message: move |
Move a message to a folder. This creates a new copy of the message in the destination folder and removes the original message. |
SuryaLashmiS |
high |
outlook |
apiPageType |
Namespace: microsoft.graph
Move a message to another folder within the specified user's mailbox. This creates a new copy of the message in the destination folder and removes the original message.
[!INCLUDE national-cloud-support]
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.
[!INCLUDE permissions-table]
POST /me/messages/{id}/move
POST /users/{id | userPrincipalName}/messages/{id}/move
POST /me/mailFolders/{id}/messages/{id}/move
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/move
Header | Value |
---|---|
Authorization | Bearer {token} . Required. |
Content-Type | application/json . Required. |
In the request body, provide a JSON object with the following parameters.
Parameter | Type | Description |
---|---|---|
destinationId | String | The destination folder ID, or a well-known folder name. For a list of supported well-known folder names, see mailFolder resource type. |
If successful, this method returns 201 Created
response code and a message resource in the response body.
Here is an example of how to call this API.
The following request moves the specified message to the Deleted Items folder, identified by its well-known folder name deleteditems
.
POST https://graph.microsoft.com/v1.0/me/messages/AAMkADhAAATs28OAAA=/move
Content-type: application/json
{
"destinationId": "deleteditems"
}
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
The following example shows the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 201 Created
Content-type: application/json
{
"@odata.context":"https://graph.microsoft.com/v1.0/$metadata#message",
"@odata.type":"#microsoft.graph.message",
"@odata.etag":"W/\"FwAAABYAAAC4ofQHEIqCSbQPot83AFcbAAAW/0tB\"",
"id":"AAMkADhAAAW-VPeAAA=",
"createdDateTime":"2018-08-12T08:43:22Z",
"lastModifiedDateTime":"2018-08-15T19:47:54Z",
"changeKey":"FwAAABYAAAC4ofQHEIqCSbQPot83AFcbAAAW/0tB",
"categories":[
],
"receivedDateTime":"2018-08-12T08:43:22Z",
"sentDateTime":"2018-08-12T08:43:20Z",
"hasAttachments":false,
"internetMessageId":"<00535324-5988-4b6a-b9af-d44cf2d0b691@MWHPR2201MB1022.namprd22.prod.outlook.com>",
"subject":"Undeliverable: Meet for lunch?",
"bodyPreview":"Delivery has failed to these recipients or groups:\r\n\r\nfannyd@contoso.com (fannyd@contoso.com)\r\nYour message couldn't be delivered. Despite repeated attempts to deliver your message, querying the Domain Name System (DNS) for the rec",
"importance":"normal",
"parentFolderId":"AAMkADhAAAAAAEKAAA=",
"conversationId":"AAQkADhJzfbkARFhe5kKhjihSA=",
"isDeliveryReceiptRequested":null,
"isReadReceiptRequested":false,
"isRead":false,
"isDraft":false,
"webLink":"https://outlook.office365.com/owa/?ItemID=AAMkADhAAAW%2FVPeAAA%3D&exvsurl=1&viewmodel=ReadMessageItem",
"inferenceClassification":"focused",
"body":{
"contentType":"html",
"content":"<html></html>"
},
"sender":{
"emailAddress":{
"name":"Microsoft Outlook",
"address":"MicrosoftExchange329e71ec88ae4615bbc36ab6ce41109e@contoso.com"
}
},
"from":{
"emailAddress":{
"name":"Microsoft Outlook",
"address":"MicrosoftExchange329e71ec88ae4615bbc36ab6ce41109e@contoso.com"
}
},
"toRecipients":[
{
"emailAddress":{
"name":"fannyd@contoso.com",
"address":"fannyd@contoso.com"
}
},
{
"emailAddress":{
"name":"danas@contoso.com",
"address":"danas@contoso.com"
}
}
],
"ccRecipients":[
],
"bccRecipients":[
],
"replyTo":[
],
"flag":{
"flagStatus":"notFlagged"
}
}