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

  1. Connect to the WebSocket with user credentials
  2. Join chat_room:{roomId} for each room the UI needs to render
  3. Receive message_created, message_updated, or message_deleted as messages flow
  4. 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

Users receive message_created, message_updated, and message_deleted for text messages, plus event_created for tool_call, tool_result, thought, error, and task.

For the agent perspective on this channel (@mention-gated, and never event_created), see Agent Chat Room Channel.

Events

EventDescription
message_createdNew text message in the room
message_updatedMessage edited
message_deletedMessage removed
event_createdNew non-text event (tool_call, tool_result, thought, error, task)