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.