---
title: "Star/Unstar Message (Realtime)"
slug: "starunstar-message-realtime"
updated: 2026-05-14T20:13:16Z
published: 2026-05-14T21:50:48Z
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Star/Unstar Message (Realtime)

![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/Deprecated.svg)

[Starring messages](https://docs.rocket.chat/v1/docs/message-actions#star-messages) enables users to save them easily for future reference or personal use.

| Method | Requires Auth | Setting |
| --- | --- | --- |
| `starMessage` | Yes | `Message_AllowStarring` |

## Payload parameters

| Argument | Example | Required | Description |
| --- | --- | --- | --- |
| `message` | ```json { "_id": "8gMsLe9ApZjo2D2iB", "rid": "64a1f373376181965ab77f54", "starred": true } ``` | Required | The message object. |

The `message` object contains the following properties:

| `_id` | `8gMsLe9ApZjo2D2iB` | Required | The message ID that you want to star or unstar. |
| --- | --- | --- | --- |
| `rid` | `64a1f373376181965ab77f54` | Required | The room ID. |
| `starred` | `true` | Required | It can only be `true` or `false`. `true`: Star the message. `false`: Unstar the message. |

## Example call

```json
{
    "msg": "method",
    "method": "starMessage",
    "id": "21",
    "params": [{
        "_id": "8gMsLe9ApZjo2D2iB",
        "rid": "64a1f373376181965ab77f54",
        "starred": true
    }]
}
```

## Example response

```json
{
    "msg": "result",
    "id": "21",
    "result": true
}
```