Oracle Beehive
  Oracle® Beehive RESTful Web Services API Reference
  Release 2 (


The Presence category enables you to control Oracle Beehive's Presence Service, which detects and identifies the status of a user or resource, and then displays that status to other users and resources in one or more clients or applications. For more information, refer to "Presence Service" in the module "Oracle Beehive Services" in Oracle Beehive Concepts in Oracle Beehive Documentation Library.

The PresenceConnectionsLimit, a system property of event subscriptions, enables you to set the maximum number of presence connections a single client may establish through Oracle Beehive RESTful Web Services. Setting this property to 0 disables presence connection initiation.

If a particular user has public presence enabled (which it is by default), any user may see that particular user's presence without a subscription.

To enable public presence for a particular user, add the public presence pseudo-user to the roster of the user and set its subscription status to ALLOWED. The ID of the public presence pseudo-user is 0000:0000:user:693446B3D1A9443F74F37D9616DC5B12000030126208. Alternatively, you may enable public presence by removing the public presence pseudo-user from the roster of the user.

To disable public presence, set the subscription status of the public presence pseudo-user to BLOCK.

To add a user to the logged in user's roster, use the PUT method /comb/v1/d/my/roster/{id}, where {id} is the user to be added. Specify the subscription status (such as ALLOWED and BLOCKED) in the state request parameter.

To remove a user from a roster, use the DELETE method /comb/v1/d/my/roster/{id}.

Related Resources