# GET /chat/rooms

**Resource:** [Chat](./chat.md)  
**MCP tool:** `list_chat_rooms`  
**Scopes:** `chat:read`  
**Write operation:** no

List chat rooms in the workspace. A room is a set of participants (a DM, a group, a self-note, or a workspace channel). Filter by room_type or is_archived. Newest activity first.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `room_type` | query | string | no | Filter by type: dm, group, self, or workspace. |
| `is_archived` | query | string | no | "true" for archived only, "all" for both. Defaults to active only. |
| `limit` | query | number | no | Max rooms to return (1-100, default 25). |
| `after` | query | string | no | Pagination cursor. |

## Request example

```bash
curl   "https://api.trustpager.com/functions/v1/api/v1/chat/rooms"   -H "Authorization: Bearer YOUR_API_KEY"
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`