MoveItem Operation
Topic Last Modified: 2009-07-16
The MoveItem operation is used to move one or more items to a single destination folder.
MoveItem Request Example
Description
The following example of a MoveItem request shows how to move an item to the drafts folder.
Code
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<MoveItem xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<ToFolderId>
<t:DistinguishedFolderId Id="drafts"/>
</ToFolderId>
<ItemIds>
<t:ItemId Id="AAAtAEF/swbAAA=" ChangeKey="EwAAABYA/s4b"/>
</ItemIds>
</MoveItem>
</soap:Body>
</soap:Envelope>
Comments
The ToFolderId element specifies the folder to which the items will be moved. Note that all items listed in the ItemIds collection will end up in the destination folder. You must make separate MoveItem calls to place items in different destination folders.
Note
The item identifier and change key have been shortened to preserve readability.
Request Elements
The following elements are used in the request:
MoveItem Response Example
Description
The following example shows a successful response to a MoveItem request.
Starting with Exchange 2007 SP1 with Update Rollup 4 (RU4) applied, the item identifier of the new item is returned in the response message. Item identifiers are not returned in responses for cross-mailbox or mailbox to public folder MoveItem operations.
Code
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="662" MinorBuildNumber="0"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"/>
</soap:Header>
<soap:Body>
<MoveItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:MoveItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:Message>
<t:ItemID Id="AAMkAd" ChangeKey="FwAAABY" />
</t:Message>
</m:Items>
</m:MoveItemResponseMessage>
</m:ResponseMessages>
</MoveItemResponse>
</soap:Body>
</soap:Envelope>
Comments
The MoveItem operation will indicate success if the move was successful.
Successful Response Elements
The following elements are used in the response: