# Messages

# Reactions

## Add

**post** `/v1/chats/{chatID}/messages/{messageID}/reactions`

Add a reaction to an existing message.

### Path Parameters

- `chatID: string`

  Unique identifier of the chat.

- `messageID: string`

### Body Parameters

- `reactionKey: string`

  Reaction key to add (emoji, shortcode, or custom emoji key)

- `transactionID: optional string`

  Optional transaction ID for deduplication and local echo tracking

### Returns

- `chatID: string`

  Unique identifier of the chat.

- `messageID: string`

  Message ID.

- `reactionKey: string`

  Reaction key that was added

- `success: true`

  Whether the reaction was successfully added

  - `true`

- `transactionID: string`

  Transaction ID used for the reaction event

### Example

```http
curl http://localhost:23373/v1/chats/$CHAT_ID/messages/$MESSAGE_ID/reactions \
    -H 'Content-Type: application/json' \
    -d '{
          "reactionKey": "x"
        }'
```

## Delete

**delete** `/v1/chats/{chatID}/messages/{messageID}/reactions`

Remove the authenticated user's reaction from an existing message.

### Path Parameters

- `chatID: string`

  Unique identifier of the chat.

- `messageID: string`

### Query Parameters

- `reactionKey: string`

  Reaction key to remove

### Returns

- `chatID: string`

  Unique identifier of the chat.

- `messageID: string`

  Message ID.

- `reactionKey: string`

  Reaction key that was removed

- `success: true`

  Whether the reaction was successfully removed

  - `true`

### Example

```http
curl http://localhost:23373/v1/chats/$CHAT_ID/messages/$MESSAGE_ID/reactions \
    -X DELETE
```