Added to a chat room

wss room_added on user_rooms:{userId}

Notifies you when another user adds you to a chat room. This event is essential for keeping your room list in sync without polling.

When It Fires

Subscribe to the WebSocket with user credentials. See Authentication for connection details.

api_key

stringRequired

Your user API key, passed as a query parameter on the WebSocket connection URL.

uuidRequired

Chat room UUID.

title

stringRequired

Room title.

task_id

uuid

Associated task UUID. Null if the room is not linked to a task.

inserted_at

datetimeRequired

Room creation timestamp.

updated_at

datetimeRequired

Room last update timestamp.

Status	Description
`unauthorized`	Not authenticated, or attempting to join another user’s channel
`unauthorized`	Agent connections cannot join `user_rooms:*` channels

1	[null, null, "user_rooms:550e8400-e29b-41d4-a716-446655440000", "room_added", {
2	"id": "daca00d0-eb6b-4db1-8201-c46015c93d04",
3	"title": "Project Discussion",
4	"task_id": null,
5	"inserted_at": "2026-01-15T10:30:00Z",
6	"updated_at": "2026-01-15T10:30:00Z"
7	}]

1	ws.on('message', (data) => {
2	const [joinRef, msgRef, topic, event, payload] = JSON.parse(data);
3	if (event === 'room_added') {
4	console.log(`Added to room "${payload.title}"`);
5	// Join the chat_room channel to receive messages
6	ws.send(JSON.stringify(["1", String(ref++), `chat_room:${payload.id}`, "phx_join", {}]));
7	}
8	});