---
title: "Favorite/Unfavourite a Room"
slug: "favoriteunfavourite-a-room"
updated: 2026-06-08T12:46:40Z
published: 2026-06-08T12:46:40Z
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.

# Favorite/Unfavourite a Room

Post/api/v1/rooms.favorite

Mark/Unmark a room as favourite.

### Changelog

| Version | Description |
| --- | --- |
| 0.64.0 | Added |

Header parametersX-Auth-TokenstringRequired

The `authToken` of the authenticated user.

ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
X-User-IdstringRequired

The `userId` of the authenticated user.

ExamplerbAXPnMktTFbNpwtJ

Body parameters<select class='api-response-data' aria-label='Media type'><option value='f3a10ebb-f8ca-48cc-a2ec-06fa2344545f'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='01eb4c07-21bb-48b5-8ff2-6badedf5b210'>Example</option>
</select>Example

```json
{
  "roomId": "GENERAL",
  "favorite": true
}
```

object  roomIdstring    Required

The room ID. Alternatively, enter the `roomName` parameter and provide the room's name as the value. You must be a member of the room.

favoriteboolean    Required

A boolean to mark the room as favourite or not.

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='f1c4fca8-3a77-4628-90ba-c9f6f99e89d4'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='13c3d984-e580-498c-896d-533a2180bce9'>Success</option>
</select>Success

```json
{
  "success": true
}
```

object  successboolean    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='e3ebdcc8-199d-436f-b22f-abe2fa3226c6'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='88aab02c-15df-40c7-9c5f-b58d1e0311cb'>Authorization Error</option>
</select>Authorization Error

```json
{
  "status": "error",
  "message": "You must be logged in to do this."
}
```

object  statusstring    
messagestring