McDewey

Multi-vendor documentation library · semantic search · MCP endpoint at /mcp

Page 247

↗ View in doc context
page
247
source
unity-connection/rest-api/cupi/cupi.md
chunk_id
unity-connection::rest-api::cupi::cupi::213

Cisco Unity Connection Provisioning Interface (CUPI) API -- Private Lists Viewing Every user with a mailbox can have private lists. To see the private lists belonging to a user, do the following GET request: GET /vmrest/users/<user object id>/privatelists/ Here is an example of the response you might receive to such a request: <?xml version="1.0" encoding="UTF-8"?> <PrivateLists total="1"> <PrivateList> <URI>/vmrest/users/f90d26fc-0e4a-405a-8c42-189a93129bdc/ privatelists/1f443e29-1d6b-4ef8-89a6-2767549e3577</URI> <ObjectId>1f443e29-1d6b-4ef8-89a6-2767549e3577</ObjectId> <DisplayName>1</DisplayName> <UserObjectId>f90d26fc-0e4a-405a-8c42-189a93129bdc</UserObjectId> <UserURI>/vmrest/users/f90d26fc-0e4a-405a-8c42-189a93129bdc</UserURI> <DtmfName>1</DtmfName> <Alias>UserA_1f443e29-1d6b-4ef8-89a6-2767549e3577</Alias> <VoiceName>6ce746b7-d775-4bc4-9d19-8b6a55b9461d.wav</VoiceName> <VoiceFileURI>/vmrest/voicefiles/ 6ce746b7-d775-4bc4-9d19-8b6a55b9461d.wav</VoiceFileURI> <NumericId>1</NumericId> <IsAddressable>true</IsAddressable> </PrivateList> </PrivateLists> Many of these fields are consistent with what you see on other objects. Specific fields that are unique to private lists and require explanation are described below. Private lists belong to specific users. The UserObjectId and UserURI field show that relationship. DtmfName is a field with a value that is automatically generated every time the display name changes on the private list. DtmfName holds the digits that would need to be dialed to address a message by name to this group by phone. Alias is a unique text name for the private list. The alias is automatically generated, and to ensure it is unique, it is constructed by concatenating the user alias, an underscore and the private list's object id. The user's alias is truncated to 28 characters to avoid overflow. NumericId is the number of the private list. Private lists are numbered 1 through 99, and when addressing a message by extension over the phone, the number can be used to choose the group. IsAddressable is an odd flag. It flags whether or not the private list is addressable. By default, all private lists are addressable. Creating The following POST creates a private list. In this example, it would be private list 2. Cisco Unity Connection Provisioning Interface (CUPI) API 215 Cisco Unity Connection Provisioning Interface (CUPI) API for User Account Settings Cisco Unity Connection Provisioning Interface (CUPI) API -- Private Lists