Skip to main content

Freeze a group channel

Freeze one or more group channels. When a group channel is frozen, all members are prevented from sending messages via the client SDK.

  • The freeze takes effect immediately.
  • The freeze persists even if the group channel is dissolved and recreated. To lift the freeze, call Unfreeze a group channel.
tip
  • Members on the allowed senders list can still send messages via the client SDK when the channel is frozen.
  • Messages sent via the Platform Chat API are not affected by the freeze.

Request

POST: https://Base URL/v4/group-channel/freeze-list/add

Rate limit: 100 per second

Signature: Required. See API request signature.

Request body

Content type: application/json

ParameterTypeRequiredDescription
channelIdsArrayYesGroup channel IDs to freeze. Max 20 per request.

Request example

HTTP
POST /v4/group-channel/freeze-list/add HTTP/1.1
Host: api.sg-light-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/json

{
"channelIds": [
"XklWnVzXm",
"LklWnVzXq"
]
}

Response

FieldTypeDescription
codeNumberReturn code. 0 indicates success.

Response example

HTTP
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
"code": 0
}