Chat
List chat messages (paginated with filters)
Authorization
tenant-api-key x-api-key<token>
Tenant API key (backend only — never expose to a browser)
In: header
Query Parameters
page?number
Range
1 <= valueDefault
1limit?number
Range
1 <= value <= 100Default
20roomId*string
Room ID (required)
messageType?string
Filter by message type
Value in
- "TEXT"
- "FILE"
- "SYSTEM"
- "ANNOUNCEMENT"
before?string
Filter messages before this ISO date
after?string
Filter messages after this ISO date
isDm?boolean
If true, return only DMs. If false/omitted, return room-wide messages only.
participantExternalId?string
Required when isDm=true. External user ID to scope DMs. Returns messages where user is sender OR recipient.
Response Body
curl -X GET "https://example.com/api/v1/chat/messages?roomId=string"Empty