Export (0) Print
Expand All
Expand Minimize

PerformReminderAction operation

Exchange Server 2013

Find information about the PerformReminderAction EWS operation.

Last modified: April 25, 2014

Applies to: Exchange Online | Exchange Server 2013 | Office 365

In this article
Using the PerformReminderAction operation
PerformReminderAction operation request example
Successful PerformReminderAction operation response
PerformReminderAction operation error response example
Additional resources

The PerformReminderAction Exchange Web Services (EWS) operation initiates a dismiss or snooze action on a reminder.

This operation was introduced in Exchange Server 2013.

You can use the PerformReminderAction operation to dismiss or snooze (delay) reminders returned by the GetReminders operation. To snooze a reminder, set the ActionType to Snooze, and set the NewReminderTime value to a time later than the current ReminderTime, otherwise the NewReminderTime is ignored by the server. If the reminder is for an occurrence of a recurring meeting, and the Snooze action is taken on the reminder with a NewReminderTime that is past the reminder of the next occurrence, the reminder is effectively dismissed.

To dismiss a reminder, set the ActionType to Dismiss. When the server processes the request, the server changes the IsReminderSet value for the item from True to False.

PerformReminderAction operation SOAP headers

The PerformReminderAction operation can use the SOAP headers that are listed in the following table.

Header name

Element

Description

Impersonation

ExchangeImpersonation

Identifies the user whom the client application is impersonating. This header is applicable to a request.

MailboxCulture

MailboxCulture

Identifies the culture, as defined in RFC 3066, "Tags for the Identification of Languages", to be used to access the mailbox. This header is applicable to a request.

RequestVersion

RequestServerVersion

Identifies the schema version for the operation request. This header is applicable to a request.

ServerVersion

ServerVersionInfo

Identifies the version of the server that responded to the request. This header is applicable to a response.

The following example of a PerformReminderAction operation request shows how to snooze a current reminder and set a new reminder time. Note that you need to include the ChangeKey for the ItemId and the NewReminderTime must be set to a time later than the ReminderTime returned by the GetReminders operation.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <t:RequestServerVersion Version="Exchange2013" />
  </soap:Header>
  <soap:Body>
    <m:PerformReminderAction>
      <m:ReminderItemActions>
        <t:ReminderItemAction>
          <t:ActionType>Snooze</t:ActionType>
          <t:ItemId Id="vwAAAA=="
           ChangeKey="DwAAABQAAACOs0HEMq1WTKpI7sNu5qXNAAAUDA=="/>
          <t:NewReminderTime>2014-04-16T17:00:00Z</t:NewReminderTime>
        </t:ReminderItemAction>
      </m:ReminderItemActions>
    </m:PerformReminderAction>
  </soap:Body>
</soap:Envelope>
NoteNote

The ItemId value has been shortened to preserve readability.

The request SOAP body contains the following elements:

The following example shows a successful response to a PerformReminderAction operation request. The UpdatedItemIds element contains the ItemIds of the updated calendar item.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <ServerVersionInfo MajorVersion="15"
                       MinorVersion="0"
                       MajorBuildNumber="921"
                       MinorBuildNumber="20"
                       Version="V2_10"
                       xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <PerformReminderActionResponse ResponseClass="Success"
                                   xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
      <UpdatedItemIds>
        <ItemId Id="vwAAAA=="
                ChangeKey="DwAAABYAAAB4to43JyybTYwHLBM1k8MxAAAJKP+S"/>
      </UpdatedItemIds>
    </PerformReminderActionResponse>
  </s:Body>
</s:Envelope>

The response SOAP body contains the following elements:

The following example shows a response to a PerformReminderAction operation request when no change was made on the server. This is a response in which a request was sent, but no UpdatedItemIds were returned, meaning no reminders were changed.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <ServerVersionInfo MajorVersion="15"
                       MinorVersion="0"
                       MajorBuildNumber="918"
                       MinorBuildNumber="7"
                       Version="V2_10"
                       xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <PerformReminderActionResponse ResponseClass="Success"
                                   xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
      <UpdatedItemIds />
    </PerformReminderActionResponse>
  </s:Body>
</s:Envelope>

The error response SOAP body contains the following elements:

For additional error codes that are generic to EWS, see ResponseCode.

Show:
© 2014 Microsoft