Skip to main content
POST
Toggle Message Reaction
Toggles an emoji reaction on a message. If the current user has not yet reacted with this emoji, the reaction is added. If they already have, it is removed. The caller must be an active member. The emoji must be exactly one grapheme cluster (a single visible character, including multi-codepoint emoji like 👨‍👩‍👧).

Path Parameters

string
required
The ID of the conversation.
string
required
The ID of the message to react to.

Body Parameters

string
required
The emoji to toggle. Must be exactly one grapheme cluster.

Response

Record<string, number>
Updated emoji reaction counts for this message (e.g. { "👍": 3, "❤️": 1 }).
string[]
The current user’s full set of reactions on this message after the toggle.
number
1 if a reaction was added, -1 if removed.

Error Responses