Skip to content

IReactions

v1 stable

/IReactions/v1/

Add and remove emoji reactions on messages, unicode or custom.

Authentication required

All endpoints require Authorization: Bot <token> header. Get a token →

POST /IReactions/v1/Add AddReactions

Adds a reaction to a message. Each user can react once per emoji. Maximum 20 unique emoji per message.

Request Body AddReactionRequest

Field Type
channelId
uuid
messageId
int64
emoji
string

Errors

Status Code Description
403 insufficient_permissions Bot does not have the AddReactions permission.
403 reactions_disabled Reactions are turned off in this announcement channel.
404 message_not_found Message does not exist in this channel.
409 already_reacted Bot has already reacted with this emoji.
422 reaction_limit_reached Maximum 20 unique emoji per message.

Example

curl -X POST \
     -H "Authorization: Bot YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"channelId":"...","messageId":"0","emoji":"..."}' \
     https://gateway.argon.zone/IReactions/v1/Add
POST /IReactions/v1/AddCustom AddReactions

Adds a custom emoji reaction (itemId: an emoji item, see IExpressions/List); its emoji reads :name:. Any bot may react with an emoji of the space the message is in. An emoji of another space is for verified bots only; others get 403 insufficient_permissions.

Request Body CustomReactionRequest

Field Type
spaceId
uuid
channelId
uuid
messageId
int64
itemId
uuid

Errors

Status Code Description
403 insufficient_permissions Bot does not have the AddReactions permission, or the emoji belongs to another space and the bot is not verified.
403 reactions_disabled Reactions are turned off in this announcement channel.
404 message_not_found Message does not exist in this channel.
404 not_found The custom emoji does not exist or was deleted, or the channel takes no reactions.
409 already_reacted Bot has already reacted with this emoji.
422 reaction_limit_reached Maximum 20 unique emoji per message.

Example

curl -X POST \
     -H "Authorization: Bot YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"spaceId":"...","channelId":"...","messageId":"0","itemId":"..."}' \
     https://gateway.argon.zone/IReactions/v1/AddCustom
POST /IReactions/v1/BatchGet

Returns current reactions for up to 50 messages in a single channel. Ideal for refreshing visible messages after reconnect.

Request Body BatchGetReactionsRequest

Field Type
channelId
uuid
messageIds
int64[]

Response BatchGetReactionsResponse

Field Type
messages MessageReactionsDto[]
↳ messageId int64
↳ reactions ReactionDto[]
↳ emoji string
↳ count int32
↳ userIds uuid[]
↳ customEmojiId uuid | null

Example

curl -X POST \
     -H "Authorization: Bot YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"channelId":"...","messageIds":[]}' \
     https://gateway.argon.zone/IReactions/v1/BatchGet
GET /IReactions/v1/List

Lists all reactions on a message. Returns emoji, count, and a preview of user IDs (up to 3).

Query Parameters

Field Type
channelId
uuid
messageId
int64

Response ListReactionsResponse

Field Type
reactions ReactionDto[]
↳ emoji string
↳ count int32
↳ userIds uuid[]
↳ customEmojiId uuid | null

Errors

Status Code Description
404 message_not_found Message does not exist in this channel.

Example

curl -X GET \
     -H "Authorization: Bot YOUR_TOKEN" \
     "https://gateway.argon.zone/IReactions/v1/List?channelId=...&messageId=..."
DELETE /IReactions/v1/Remove

Removes the bot's reaction from a message. Only the bot's own reaction can be removed.

Request Body RemoveReactionRequest

Field Type
channelId
uuid
messageId
int64
emoji
string

Errors

Status Code Description
404 message_not_found Message does not exist in this channel.
404 reaction_not_found Bot has not reacted with this emoji.

Example

curl -X DELETE \
     -H "Authorization: Bot YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"channelId":"...","messageId":"0","emoji":"..."}' \
     https://gateway.argon.zone/IReactions/v1/Remove
POST /IReactions/v1/RemoveCustom

Removes the bot's custom emoji reaction, also after the emoji was deleted.

Request Body CustomReactionRequest

Field Type
spaceId
uuid
channelId
uuid
messageId
int64
itemId
uuid

Errors

Status Code Description
404 message_not_found Message does not exist in this channel.
404 reaction_not_found Bot has not reacted with this emoji.

Example

curl -X POST \
     -H "Authorization: Bot YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"spaceId":"...","channelId":"...","messageId":"0","itemId":"..."}' \
     https://gateway.argon.zone/IReactions/v1/RemoveCustom