Delete user channel tags

Delete one or more channel tags for a specified user. Deleting a tag automatically removes all channel-tag associations, but does not delete the channels themselves.

danger

This operation is irreversible. All channels under the deleted tags lose their tag association. Confirm the tags are no longer needed before deleting.

Request

POST: https://[Base URL](/platform-chat-api/base-url)/v4/user/channel/tag/remove

Rate limit: 100 per second

Signature: Required. See API request signature.

Request body

Content type: application/json

Parameter	Type	Required	Description
userId	String	Yes	The user ID.
tagIds	String[]	Yes	Tag IDs to delete. Max 20 per request.

Request example

HTTP

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

{
    "userId": "testUserId",
    "tagIds": ["tag1", "tag2"]
}

Response

Field	Type	Description
code	Number	Return code. 0 indicates success.

Response example

HTTP

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

{"code":0}