UpdateItem

The UpdateItem element defines a request to update an item in a mailbox.

<UpdateItem ConflictResolution="" MessageDisposition="" SendMeetingInvitationsOrCancellations="" SuppressReadReceipts="">
   <SavedItemFolderId/>
   <ItemChanges/>
</UpdateItem>

UpdateItemType

Attributes and elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description
ConflictResolution
Identifies the type of conflict resolution to try during an update. The default value is AutoResolve.
MessageDisposition
Describes how the item will be handled after it is updated. The MessageDisposition attribute is required for message items, including meeting messages such as meeting cancellations, meeting requests, and meeting responses.
SendMeetingInvitationsOrCancellations
Describes how meeting updates are communicated after a calendar item is updated. This attribute is required for calendar items and calendar item occurrences.
SuppressReadReceipts
Indicates whether read receipts for the updated item should be suppressed. A text value of true indicates that read receipts should be suppressed. A value of false indicates that the read receipts will be sent to the sender. This attribute is optional.
This attribute was introduced in Exchange Server 2013 SP1.

ConflictResolution Attribute

Value Description
NeverOverwrite
If there is a conflict, the update operation fails and an error is returned.
AutoResolve
The update operation automatically resolves any conflict.
AlwaysOverwrite
If there is a conflict, the update operation will overwrite information.

MessageDisposition Attribute

Value Description
SaveOnly
The item is updated and saved back to its current folder.
SendOnly
The item is updated and sent but no copy is saved.
SendAndSaveCopy
The item is updated and a copy is saved in the folder identified by the SavedItemFolderId element.

SendMeetingInvitationsOrCancellations Attribute

Value Description
SendToNone
The calendar item is updated but updates are not sent to attendees.
SendOnlyToAll
The calendar item is updated and the meeting update is sent to all attendees but is not saved in the Sent Items folder.
SendOnlyToChanged
The calendar item is updated and the meeting update is sent only to attendees that are affected by the change in the meeting.
SendToAllAndSaveCopy
The calendar item is updated, the meeting update is sent to all attendees, and a copy is saved in the Sent Items folder.
SendToChangedAndSaveCopy
The calendar item is updated, the meeting update is sent to all attendees that are affected by the change in the meeting, and a copy is saved in the Sent Items folder.

Child elements

Element Description
SavedItemFolderId
Identifies the target folder for operations that update, send, and create items in the Exchange store.
ItemChanges
Contains an array of ItemChange elements that identify items and the updates to apply to the items.

Parent elements

None.

Remarks

The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services.

Element information

Name Value
Namespace
https://schemas.microsoft.com/exchange/services/2006/messages
Schema Name
Messages schema
Validation File
Messages.xsd
Can be Empty
False

See also

UpdateItem operation