messenger_rooms_get

# messenger_rooms_get

Read chat rooms in the Messenger app (pApp D00003). View rooms (chatRoomType ALL|DIRECT|GROUP, search, paging), room, participants or messages with roomUuid and roomType, or oldest for unanswered direct chats. Returns the roomUuid and messageUuid values other tools take. Hidden message content is excluded; reading marks nothing read.

## Inputs

| Field | Required here | Contract |
| --- | --- | --- |
| `view` | Yes | one of: `oldest`, `rooms`, `room`, `participants`, `messages` |
| `minThresholdInDays` | No | When `view` is `oldest`: integer; minimum 0 |
| `maxThresholdInDays` | No | When `view` is `oldest`: integer; minimum 0 |
| `after` | No | When `view` is `oldest`: integer; greater than 0 |
| `limit` | No | When `view` is `oldest`: integer; maximum 100; greater than 0; default `20` |
| `chatRoomType` | No | When `view` is `rooms`: `ALL`, `DIRECT`, `GROUP`; default `ALL` |
| `quietStatus` | No | When `view` is `rooms`: `quiet`, `active`, `all`; default `all` |
| `search` | No | When `view` is `rooms`: string; max length 200 |
| `page` | No | When `view` is `rooms`: integer; greater than 0; default `1` |
| `limit` | No | When `view` is `rooms`: integer; maximum 100; greater than 0; default `20` |
| `roomUuid` | Yes | When `view` is `room`: string; pattern `^[A-Za-z0-9_-]{1,200}$` |
| `roomType` | Yes | When `view` is `room`: `DIRECT`, `GROUP` |
| `roomUuid` | Yes | When `view` is `participants`: string; pattern `^[A-Za-z0-9_-]{1,200}$` |
| `roomType` | Yes | When `view` is `participants`: `DIRECT`, `GROUP` |
| `participantType` | No | When `view` is `participants`: `SELLER_PERFORMER`, `SELLER`, `ADMIN`, `MANAGERS`, `USER`, `ALL`; default `ALL` |
| `page` | No | When `view` is `participants`: integer; greater than 0; default `1` |
| `limit` | No | When `view` is `participants`: integer; maximum 100; greater than 0; default `20` |
| `roomUuid` | Yes | When `view` is `messages`: string; pattern `^[A-Za-z0-9_-]{1,200}$` |
| `roomType` | Yes | When `view` is `messages`: `DIRECT`, `GROUP` |
| `messageType` | No | When `view` is `messages`: `ALL`, `TEXT`, `IMAGE`, `VIDEO`, `ATTACHMENT`, `TRANSACTION`, `DONATION`, `HIDE`, `SYSTEM`; default `ALL` |
| `cursor` | No | When `view` is `messages`: integer; greater than 0 |
| `limit` | No | When `view` is `messages`: integer; maximum 100; greater than 0; default `20` |