replyRequest

Replies to an existing message.

Request

<replyRequest>
   <id type="types:uid"/>
   <view type="string"/>
</replyRequest>

Response

<replyResponse>
   <item type="types:Item"/>
   <status type="types:Status"/>
</replyResponse>

Elements

id

Specifies the ID of the item you want to reply to.

view

Specifies whether you want the original message body returned in the reply call:

  • message

  • message/RTF

  • recipients-Replies to all recipients. Otherwise, the reply applies to the sender only.

item

Returns an item that can be modified and passed to sendRequest to complete the reply.

code

Returns the error number related to the event. 0 indicates that the request was successful.

status

Returns the success or failure of the method.

Remarks

Replying to a message is a two-step process. The first step is to call the reply method with the ID of the item that you want to reply to. A new mail item is then returned with the original subject and other fields that are specified in the view. An element called linkInfo is returned in this item.

The second step is to create a new item to send. The linkInfo element needs to be passed unchanged in the sendRequest. The new item can then be modified at will. For example, you might want to prepend “Re:” to the beginning of the subject. The message body can also be modified and attachments added.

Example

<replyRequest> 
   <id>450FE559.domain1.po1.100.16E3837.1.1030.1@1:7.
                    domain1.po1.100.0.1.0.1@16</id> 
   <view/> 
</replyRequest>

<replyResponse>
   <item type="Mail"> 
      <source>sent</source> 
      <subject>Re: Reply - threaded message</subject> 
      <distribution/> 
      <link> 
         <id>0:4144</id> 
         <type>reply</type> 
      </link> 
   </item> 
   <status> 
      <code>0</code> 
   </status> 
</replyResponse>