Chat Room Channel
wss chat_room:{roomId}
The primary channel for real-time messaging. Your front-end subscribes per room to drive the chat UI and receive every text message lifecycle event for rooms the user participates in.
Where It Fits
- Connect to the WebSocket with user credentials
- Join
chat_room:{roomId}for each room the UI needs to render - Receive
message_created,message_updated, ormessage_deletedas messages flow - Send messages via
POST /me/chats/{id}/messages; this channel only delivers server-pushed events
Topic Pattern
chat_room:{roomId} where {roomId} is the UUID of the chat room.
Access Control
- The user must be a participant in the chat room to join
- Unauthorized join attempts receive an error response
Only message_type: "text" messages are delivered via WebSocket. Non-text types (system, action, thought, guidelines, error, tool_call, tool_result, task) are not pushed over this channel — fetch them via GET /me/chats/{id}/messages if needed.
For the agent perspective on this channel (with @mention filtering), see Agent Chat Room Channel.