---
title: "Favorite/Unfavourite a Room"
slug: "favoriteunfavourite-a-room"
updated: 2026-09-03T14:50:33Z
published: 2026-09-03T14:50:33Z
canonical: "developer.rocket.chat/favoriteunfavourite-a-room"
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='a5ce5ed1-18ee-414b-8cd2-07f7c72bf57d'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='395bc9ff-5f06-46d8-81b4-e40638102722'>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='ddc0badb-bb5b-4daa-89ea-b808ee103d34'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='de41d018-ed77-4317-a016-bdb12cfaca6b'>Success</option>
</select>Success

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

object  successboolean    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='9394dfdb-618b-4318-9995-13c8e981990c'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='d0c29e74-9fb5-4486-a0f4-5bb7d11820f2'>Authorization Error</option>
</select>Authorization Error

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

object  statusstring    
messagestring