Skip to content

IReactions

v1 stable

/IReactions/v1/

Add and remove emoji reactions on messages.

a192cbc985de63a7… SHA-256 contract hash — guaranteed stable

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 string
emoji string
messageId int64

Errors

Status Code Description
403 insufficient_permissions Bot does not have the AddReactions permission.
403 not_a_member Bot is not a member of this space.
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":"...","emoji":"...","messageId":"0"}' \
     https://gateway.argon.zone/IReactions/v1/Add
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 string
messageIds int64[]

Response BatchGetReactionsResponse

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

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).

Response ListReactionsResponse

Field Type
reactions ReactionDto[]
↳ count int32
↳ emoji string
↳ userIds string[]

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
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 string
emoji string
messageId int64

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":"...","emoji":"...","messageId":"0"}' \
     https://gateway.argon.zone/IReactions/v1/Remove