reaction_remove

Remove one of the signed-in user’s reactions from a message. Use it when someone clicks an emoji they already reacted with.

Request

{
  "cmd": "reaction_remove",
  "channel": "general",
  "id": "8f14e45f-ceea-467a-9575-3d3b4c1b2a10",
  "emoji": "👍"
}

Field	Type	Required	Description
`channel`	string	One of `channel` or `thread_id`	Name of the channel that holds the message. Leave it out for a thread message.
`thread_id`	string	One of `channel` or `thread_id`	ID of the thread that holds the message. If you also send `channel`, it must be the thread’s parent forum.
`id`	string	Yes	ID of the message.
`emoji`	string	Yes	The reaction to remove, 1 to 200 characters. Send the exact string used when it was added.

Response

{
  "cmd": "reaction_remove",
  "channel": "general",
  "id": "8f14e45f-ceea-467a-9575-3d3b4c1b2a10",
  "emoji": "👍",
  "from": "alice",
  "total": 2,
  "reactions": {
    "👍": ["2f1c9a", "7b3e0d"],
    "🎉": ["2f1c9a"]
  }
}

from is the username of the user who removed the reaction.
total is how many users still have this emoji. When it reaches 0, the emoji is gone from the message.
reactions is the message’s full reaction map after the change. It is empty ({}) when no reactions are left.
For a thread message, channel is the parent forum and the frame also has thread_id.

The same frame is broadcast to every other connection whose user can view the channel, without listener. Users severed from the reacting user don’t receive it. Severing hides two users from each other; a user with manage_users sets it with the /sever slash command.

Permissions

You need to be able to view the channel (or the thread’s parent forum) and hold its react channel permission. You can only remove your own reactions.

The command is blocked while you are timed out.

Errors

`val`	When
`Failed to remove reaction '<emoji>' from message <id>. You may have not reacted with this emoji.`	You don’t have this reaction on the message.
`Channel not found`	The channel doesn’t exist, or you sent neither `channel` nor `thread_id`.
`Thread not found`	No thread has this `thread_id`.
`Thread does not belong to this channel`	`channel` is not the thread’s parent forum.
`Messages must be sent inside a thread in forum channels`	`channel` is a forum. Send `thread_id` instead.
`This channel does not support chat`	The channel type has no messages.
`Access denied to this channel`	You can’t view the channel.
`You do not have permission to view this thread`	You can’t view the thread’s parent forum.
`You do not have permission to react in this channel`	You lack the `react` permission.
`Message not found`	No message has this `id` in the channel or thread.
Validation message	A field is missing or has the wrong type or length, for example `emoji: Required`.

See also