METHOD_PC_DisableRoom

This method disables a group discussion. Only managers of a group discussion can disable the group discussion.

Note: When users disable a group discussion, only the persistent chat administrator can enable it again.

The following table describes the parameters that you can include in this method.

Parameter

Type

Required

Description

roomId

String

√

This parameter specifies the ID of the group discussion to disable.

InnerError

The following errors might occur when disabling a group discussion:

  • The group discussion identified by the group discussion ID doesn't exist.

Code example

The following example sends a disable group discussion request to BEMS.

{
  "method":"pc.DisableRoom",
  "params":
   {
    "roomId":"ma-chan://gems.sw.rim.net/79b523a6-c78b-4cec-be33-4c2f14ce1438"
   },
  "id":"c5",
  "jsonrpc":"2.0"
}

If the request is successful, BEMS sends the following response to the BlackBerry Connect app and processes the request

{
  "id":"c5",
  "error":null,
  "result":
   {
    "data":
     {
       "method":"pc.DisableRoom",
       "state":"PROCESSING"
     }
   },
 "jsonrpc":"2.0"
}

If there are no error messages, BEMS sends the following notification to the BlackBerry Connect app and disables the group discussion.

{
 "id":"c5",
 "sequence":1018694300000010,
 "result":
  {
   "data":
    {
      "method":"pc.DisableRoom",
      "state":"COMPLETE"
    }
  },
 "jsonrpc":"2.0"
}