2.2.1.12 MoveItems

The MoveItems command moves an item or items from one folder on the server to another.

The item to be moved is identified by its server ID in the MoveItems command request (section 2.2.1.12). The source and destination folders are also identified by their server IDs in the command request. The MoveItems command response shows the status of the move, the message that was moved, and the new message ID.

When items are moved between folders on the server, the client receives Delete (section 2.2.3.42) and Add (section 2.2.3.7) operations the next time the client synchronizes the affected folders.

An item that has been successfully moved to a different folder can be assigned a new server ID by the server.

The Move namespace is the primary namespace for this section. Elements referenced in this section that are not defined in the Move namespace use the namespace prefixes defined in section 2.2.4.

The following table lists the elements that are used in MoveItems command requests and responses.

Element name	Scope	Reference
MoveItems	Request and Response	section 2.2.3.119
Move	Request	section 2.2.3.117.2
SrcMsgId	Request and Response	section 2.2.3.175
SrcFldId	Request	section 2.2.3.174
DstFldId	Request	section 2.2.3.51.2
Response	Response	section 2.2.3.153.5
Status	Response	section 2.2.3.177.10
DstMsgId	Response	section 2.2.3.52

The XML schema for the MoveItems command request is described in section 6.27. The XML schema for the MoveItems command response is described in section 6.28.

Protocol Versions

The following table specifies the protocol versions that support this command. The client indicates the protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.

Protocol version	Command support
2.5	Yes
12.0	Yes
12.1	Yes
14.0	Yes
14.1	Yes
16.0	Yes
16.1	Yes