Skip to main content

Remove private subchannel members

Remove users from the private subchannel member list for a specified community channel subchannel.

All user IDs must be community channel members. If any user is not a community channel member, the entire request fails.

tip

When a member leaves the community channel, they are automatically removed from all private subchannel member lists.

Request method

POST: https://Base URL/v4/community-channel/private-subchannel/member/remove

Rate limit: 100 requests per second

Signature required: All server API requests require signature verification. See API request signature.

Request body

The request body is in application/json format and supports the following parameters:

ParameterTypeRequiredDescription
channelIdStringYesThe community channel ID.
subchannelIdStringYesThe subchannel ID.
userIdsArrayYesList of user IDs. Maximum 20 per request.

Request example

HTTP
POST /v4/community-channel/private-subchannel/member/remove HTTP/1.1
Host: api.sg-light-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/json

{
"channelId": "abc",
"subchannelId": "channel001",
"userIds": ["user1", "userId2"]
}

Response

The response body contains a JSON object with the following structure:

FieldTypeDescription
codeNumberStatus code. 0 indicates success.

Response example

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

{"code":0}