PLEXICHATNarrative Docs

Reactions

Guides, route-group overviews, and live schema entry points for the Plexichat backend.

REST http://api.plexichat.com/api/v1Gateway ws://api.plexichat.com/gatewayVersion a.1.0-49

Reactions API

Endpoints for managing message reactions.

PUT /channels/{channel_id}/messages/{message_id}/reactions/{emoji}

Add a reaction to a message.

Headers


Authorization: Bearer <token>

Path Parameters

Parameter	Type	Description
channel_id	string	Channel's snowflake ID
message_id	string	Message's snowflake ID
emoji	string	Emoji (Unicode or custom ID)

Response (200 OK)


{
  "success": true
}

Error Responses

Status	Code	Description
400	Invalid emoji	Emoji not recognized
400	Reaction limit	Too many reactions on message
403	Permission denied	No add reactions permission
404	Message not found	Message doesn't exist

DELETE /channels/{channel_id}/messages/{message_id}/reactions/{emoji}

Remove your reaction from a message.

Headers


Authorization: Bearer <token>

Response (200 OK)


{
  "success": true
}

The endpoint returns a successful response regardless of whether the reaction previously existed, ensuring idempotent behavior for reaction removal operations.

GET /channels/{channel_id}/messages/{message_id}/reactions

Get all reactions on a message.

Headers


Authorization: Bearer <token>

Response (200 OK)


[
  {
    "emoji": ":thumbsup:",
    "count": 5,
    "me": true
  },
  {
    "emoji": ":heart:",
    "count": 3,
    "me": false
  }
]

Error Responses

Status	Code	Description
400	Invalid message ID	ID format invalid
404	Message not found	Message doesn't exist

GET /channels/{channel_id}/messages/{message_id}/reactions/{emoji}

Get users who reacted with a specific emoji.

Headers


Authorization: Bearer <token>

Query Parameters

Parameter	Type	Default	Constraints	Description
limit	int	50	1-100	Max users to return
after	string	-	Snowflake ID	Get users after this ID

Response (200 OK)


[
  {
    "user_id": "123456789012345678",
    "reacted_at": 1704067200
  },
  {
    "user_id": "234567890123456789",
    "reacted_at": 1704067300
  }
]

Error Responses

Status	Code	Description
400	Invalid message ID	ID format invalid
404	Message not found	Message doesn't exist

Reaction Object


{
  "emoji": ":thumbsup:",
  "count": 5,
  "me": true
}

Field	Type	Description
emoji	string	Emoji identifier
count	int	Number of users who reacted
me	bool	Whether current user reacted

Reaction User Object


{
  "user_id": "123456789012345678",
  "reacted_at": 1704067200
}

Field	Type	Description
user_id	string	User's snowflake ID
reacted_at	int	Unix timestamp of reaction

Emoji Format

Reactions support:

Unicode emoji: :thumbsup:, :heart:, :tada:
Custom emoji: emoji_id (snowflake ID)