updateContact Request

Article
05/23/2014

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Updates the setting of a contact.

Syntax

<updateContact rid="9">
   <contact uri="sip:jessicaa@contoso.com" name="jessica arnold" subscribed="true"
   tag="false" groups="1 2 3"/>
</updateContact>

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

Attributes

Attribute	Data Type	Description
rid	string	Represents the client-assigned instance ID for this request. This is a required attribute.

Element Information

Parent Element

Element	Description
cwaRequests	Contains one or more methods that a Unified Communications AJAX API Client sends to a Communicator Web Access Server.

Child Elements

Element	Occurrence	Description
Contact	1	A person in a contact list. The attribute values indicate subscription and tag status. In addition, the groups that the contact has been assigned to are listed.

Remarks

This request allows the Unified Communications AJAX API Client application to update a user in their contact list. Communicator Web Access Server responds synchronously on the command channel and asynchronously on the data channel. The asynchronous event response holds an updated list of the logged-on user's contacts.

Examples

XML example of the request

The following requests attempts to tag the contact (alice@contoso.com).

<updateContact rid="100">
   <contact uri="sip:alice@contoso.com" name="alice" subscribed="true"
   tag="false" groups="1 2 3" />
</updateContact>

Share via