---
title: "Rooms"
slug: "rooms-management-api"
status: "update"
updated: 2026-09-15T13:45:25Z
published: 2026-09-15T13:49:49Z
canonical: "developer.rocket.chat/rooms-management-api"
---

> ## 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.

# Rooms

Conversations take place in rooms. Rocket.Chat has different types of rooms that can be used for different purposes. For more information, see the [Collaborate Using Rooms](https://docs.rocket.chat/docs/rooms) section.

## The room object

Every conversation container — channel, private group, direct message, team main room, or omnichannel conversation — is a room and shares one object shape. A trimmed example from [Get Room Information](https://developer.rocket.chat/apidocs/get-room-information):

```json
{
  "room": {
    "_id": "66ed2dba40141d95f32c292b",
    "name": "new-channel",
    "t": "p",
    "msgs": 3,
    "usersCount": 2,
    "u": { "_id": "C38WSSzrGd2NCjzqJ", "username": "test.cat" },
    "teamId": "66c82d78237405fc05fc1ef1",
    "ro": false,
    "default": false,
    "ts": "2024-09-20T08:09:30.417Z"
  },
  "success": true
}
```

Fields you use most often:

- `_id`: The room ID, passed as `roomId` or `rid` in requests.
- `t`: The room type — `c` public channel, `p` private group, `d` direct message, `l` livechat. The type decides which API manages the room: [Channels](https://developer.rocket.chat/apidocs/channels-api) for `c`, [Groups](https://developer.rocket.chat/apidocs/groups-api) for `p`, and the [Rooms API](https://developer.rocket.chat/apidocs/rooms-api) for actions that work across all types.
- `teamId`: Set when the room belongs to a [team](https://developer.rocket.chat/apidocs/teams-api).
- `u`: The user who created the room.

This API section includes the following:

#### Groups API

- Create and manage the status of private channels—archive, unarchive, encrypt, set announcements, and more.
- Add and remove members in private channels.
- Update members’ roles in private channels.
- View information such as members, integrations, messages, and files.

#### Channels API

- Create and manage the status of public channels—archive, unarchive, encrypt, set announcements, and more.
- Add and remove members in public channels.
- Update members’ roles in public channels.
- View information such as members, integrations, messages, and files.

#### Rooms API

- Perform general room actions—send files, change settings, export room details, and more.
- Create and view room discussions.
- Mark a room as favorite, mute and unmute users, and view other details.

#### Teams API

- Create public and private teams.
- Manage team members by adding and removing them, and updating member information.
- Convert a team to a channel and add rooms to a team.

#### Directory API

- Search the workspace directory for users, channels, and teams.

> [!NOTE]
> - The actions that you can perform and the details you can view depend on your role and permissions. Additional required permissions are stated in the endpoint descriptions.
> - You can learn more about the properties associated with rooms from the [Room schema definition](/v1-api/apidocs/room-schema).

## Common workflows

**Invite people to a room with an invite link**

1. [Find or create an invite](https://developer.rocket.chat/apidocs/find-or-create-invite) for the room, setting how many days it lasts and how many times it can be used.
2. Share the invite link; the recipient joins by [using the invite token](https://developer.rocket.chat/apidocs/use-invite-token).
3. [List the invites](https://developer.rocket.chat/apidocs/list-invites) and [delete an invite](https://developer.rocket.chat/apidocs/delete-invite-by-id) when it should stop working.

**Track a user's read state across rooms**

1. [Get all subscriptions](https://developer.rocket.chat/apidocs/get-all-subscriptions) to see every room the user is in, with unread counts and alerts.
2. [Mark a room as read](https://developer.rocket.chat/apidocs/mark-channel-as-read) or [unread](https://developer.rocket.chat/apidocs/mark-channel-as-unread) to update it.

## Conventions

- Endpoints reference rooms by `roomId` (also seen as `rid`); Channels and Groups endpoints usually accept `roomName` too. IDs are safer because names can change.
- Type-specific management lives in the Channels, Groups, and Teams APIs; the Rooms API works across all room types.
- A [subscription](https://developer.rocket.chat/apidocs/subscription-schema) is the per-user view of a room — unread counts, alerts, and preferences — managed through the Subscriptions API.
- List endpoints support `count`, `offset`, `sort`, and `query` [query parameters](https://developer.rocket.chat/apidocs/query-parameters).