1. REST API Support for Squared UC in Unity Connection 11.5
EDCS
July 15, 2015

2. Notice
The information in this presentation is provided under Non-Disclosure agreement and should be treated as Cisco Confidential. Under no circumstances is this information to be shared further without the express consent of Cisco.
Any roadmap item is subject to change at the sole discretion of Cisco, and Cisco will have no liability for delay in the delivery or failure to deliver any of the products or features set forth in this document.

3. Agenda Introduction CUPI API CUMI API Users query enhancement
'USN' and 'UID Validity' information of supported mailbox folders
Message query support with USN 'greater than' search criteria

4. Introduction
Release 11.5 onwards, below enhancements have been incorporated:
CUPI API
Added support for searching of users based on ‘Corporate Address’
CUMI API
Added support for mailbox synchronization based on ‘USN’ and ‘UID Validity’ attributes
Added support to search user messages with USN ‘greater than’ a given value

5. CUPI API - Users Query Enhancement

6. Overview
Enhanced CUPI API to allow searching of users based on "Corporate Address".
Supported CUPI API Query Structures are : is
startswith
isnotnull)
isnull)
NOTE :If there are more than one user with the same ‘Corporate Address’, all users will be listed.

7. Example of CUPI Users query:

8. CUMI API – 'USN' and 'UID Validity' information of mailbox folders

9. Overview
To extend the functionality of mailbox folders, additional attributes will be returned on executing the mailbox query:
USN (Unique Sequence Number)
UID Validity (Unique Identifier Validity) – Creation time of mailbox.

10. Example of earlier response
Earlier response attributes:
URI
Display Name
Message Count

11. New Response of mailbox query
New attributes shown in the response below:
USN
UID Validity
NOTE : Doing any operation on Inbox folder will impact the USN of both ‘Inbox’ and ‘Deleted’ folder.

12. ‘Inbox’ folder example
Sending an HTTP GET Request to the URI, server generated response will be as shown below:

13. 'Deleted' folder example

14. 'Sent' folder example

15. CUMI API - Message query Support with USN 'greater than’ search criteria

16. Overview
CUMI API has been extended to fetch the messages having USN greater than any given value.
Supported CUMI API query structure for Inbox/Sent/Deleted folder is:
folder>/messages?userobjectid=<userobjectid>&<usngreaterthan= number>
Sample query:
s?userobjectid=< f-d d- cbe466a9f938>&usngreaterthan=<6>

17. 'Inbox' folder example
Sending an HTTP GET Request to the URI, server generated response will be as shown below:

18. 'Sent' folder example

19. 'Deleted' folder example

20. Troubleshooting Find Troubleshooting tips at the below link:

21. References Doc Wiki Links:
User_API#Listing_Users_based_on_ _Address
dev.cisco.com/wiki/Cisco_Unity_Connection_Messaging_Interface_%28CUMI%29_API_-- _Using_the_CUMI_API#Filtering