# Remove reaction from message

`POST /reaction.remove`

## Description

Remove a reaction from a message in a chat.

Only reactions added by the authenticated app can be removed.

To remove a reaction from a thread reply, provide the `threadTimestamp` of the parent message
and the `timestamp` of the specific reply.

**Required scope:** `chat:send_message` or `chat:write`

---

**OpenAPI Spec:** [chat-v1.json](https://developer.ro.am/chat-v1.json)

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Request Body

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `chatId` | string | Yes | The chat containing the message. |
| `timestamp` | integer | Yes | Timestamp of the message (Unix microseconds). |
| `threadTimestamp` | integer | No | Timestamp of the parent thread message (Unix microseconds), if removing from a thread reply. |
| `name` | string | Yes | Name of the reaction to remove (e.g. "thumbs_up", "heart"). |

### Example Request

```json
{
  "chatId": "7be17589-4b9a-4524-bddb-ce60abea08e6",
  "timestamp": 1755723832718034,
  "name": "thumbs_up"
}
```

## Responses

### 200 - Reaction successfully removed

### 400 - Bad request. Common causes:
- Message not found
- Reaction not found


### 401 - Presented invalid authentication credentials.

### 403 - Forbidden. Common causes:
- Bot does not have access to this chat
- Reaction was not added by this app


### 405 - An unsupported method was requested.

### 500 - An internal error occurred.

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/api/reaction-remove*