Fetch Reaction Users

List users who reacted to a message with a specific emoji

GET /:projectId/api/v7/conversations/:conversationId/messages/:messageId/reactions

Fetch Reaction Users

cURL

curl --request GET \
  --url https://api.sublay.io/api/v6/:projectId/api/v7/conversations/:conversationId/messages/:messageId/reactions

200

{
  "data": [
    {
      "user": {},
      "emoji": "<string>",
      "createdAt": "<string>"
    }
  ],
  "pagination": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "hasMore": true
  }
}

Returns a paginated list of users who reacted with a given emoji on a message. Useful for rendering a “who reacted” popover. The caller must be a member of the conversation.

Path Parameters

conversationId · string · required

The ID of the conversation.

messageId · string · required

The ID of the message.

Query Parameters

emoji · string · required

The emoji to filter by.

page · number

Page number (1-based). Defaults to 1.

limit · number

Number of reactions per page. Defaults to 50. Max 100.

Space-scoped reputation

This endpoint has a space in context, so it accepts the opt-in reputation params. They add a spaceReputation field to each reactor’s user, alongside the always-present reputation total. Requires the reputation bundle. See the Reputation data model for the full contract.

spaceReputationId · string

Adds spaceReputation to each returned user. One of: a space <uuid> (that space’s bucket), none (the project-general bucket), or context (the space derived from this request’s context — per-row on lists). The empty string and the legacy general / null aliases are rejected (400). Missing buckets read as 0.

spaceReputationDescendants · boolean

Only honored with an explicit space <uuid>. When true, spaceReputation is the subtree sum — the space plus all of its descendants (the root space’s own bucket included). Ignored for none; not allowed with context.

Response

data · array

Array of reaction entries, ordered by createdAt ascending.

Show properties

user · object

User who reacted. Includes id, name, username, avatar.

emoji · string

The emoji for this reaction.

createdAt · string

Timestamp when the reaction was added.

pagination · object

Show properties

page · number

Current page.

limit · number

Items per page.

total · number

Total number of reactions for this emoji.

hasMore · boolean

Whether more pages exist.

Error Responses

Forbidden — 403

{ "error": "You are not a member of this conversation.", "code": "chat/not-a-member" }

Not Found — 404

{ "error": "Message not found.", "code": "chat/message-not-found" }