ConversationAction

Article
03/29/2023

The ConversationAction element contains a single action to be applied to a single conversation.

<ConversationAction>
   <Action/>
   <ConversationId/>
   <ContextFolderId/>
   <ConversationLastSyncTime/>
   <ProcessRightAway/>
   <DestinationFolderId/>
   <Categories/>
   <EnableAlwaysDelete/>
   <IsRead/>
   <DeleteType/>
</ConversationAction>

ConversationActionType

Attributes and elements

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

Attributes

None.

Child elements

Element	Description
Action (ConversationActionTypeType)	Contains the action to perform on the conversation specified by the ConversationId element. This element must be present.
ConversationId	Contains the identifier of the conversation that will have the action specified by the Action (ConversationActionTypeType) element applied to items in the conversation. This element must be present.
ContextFolderId	Indicates the folder that is targeted for actions that use folders. This element must be present when copying, deleting, moving, and setting read state on conversation items in a target folder.
ConversationLastSyncTime	Contains the date and time that a conversation was last synchronized. This element must be present when trying to delete all items in a conversation that were received up to the specified time.
ProcessRightAway	Indicates whether the response is sent as soon as the action starts processing on the server or whether the response is sent after the action has completed. This element must be present for the response to be sent asynchronous to the requested action.
DestinationFolderId	Indicates the destination folder for copy and move actions.
Categories	Contains a collection of strings that identify the categories to which items in a conversation belong.
EnableAlwaysDelete	Specifies a flag that enables deletion for all new items in a conversation.
IsRead	Indicates whether a message has been read.
DeleteType	Indicates how items in a conversation are deleted.

Parent elements

Element	Description
ConversationActions	Contains a collection of conversations and the actions to apply to them.

Text value

ConversationAction element text values

Value	Description
AlwaysCategorize	Always categorize the conversation.
AlwaysDelete	Always delete the conversation.
AlwaysMove	Always move the conversation.
Delete	Delete the conversation.
Move	Move the conversation.
Copy	Copy the conversation.
SetReadState	Set the read state of the conversation.
SetRetentionPolicy	Set the retention policy for the conversation.

Remarks

The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services.This element was introduced in Exchange Server 2010 Service Pack 1 (SP1).

Element information

Element	Example
Namespace	https://schemas.microsoft.com/exchange/services/2006/types
Schema Name	Types schema
Validation File	Types.xsd
Can be Empty	False