Skip to content

Group chats

Group chats are shared with the workspace. Paths are relative to /api/workspaces/{workspaceId}.

Method Path Does
GET /rooms/ List group chats
POST /rooms/ Create: { "agentIds": ["…", "…"], "title": "…" }
GET /rooms/{roomId} Read one
POST /rooms/{roomId} Send a message: { "content": "…" }; replies stream back as JSON lines
PATCH /rooms/{roomId} Change title, description, pinned or archived
POST /rooms/{roomId}/members Add bots: { "agentIds": ["…"] }
POST /rooms/{roomId}/kickoff Let newly added bots introduce themselves (streams)
GET /rooms/{roomId}/decisions Turn-taking decisions: who was picked to answer, and why

A group needs at least two different bots from this workspace. Adding bots skips ids that are unknown or already in the chat rather than failing. Closing the request of a streaming call stops the bots, like the Stop button.