chatrooms

Create Breakouts

Split a class room's current participants into balanced breakout rooms.

Host (room creator) or admin only. Distribution balances the two exchange sides unless the teacher supplies explicit assignments. Returns the child rooms + who goes where; the teacher's client then broadcasts each assignment over the parent room's data channel so students auto-move.

post/chatrooms/{room_name}/breakouts

Path parameters

room_namestring required

Headers

authorizationstring nullable

Request body

taskstring nullable

num_roomsinteger nullable

group_sizeinteger nullable

half_minutesinteger nullable

duration_minutesinteger nullable

language_astring nullable

language_bstring nullable

hosted_by_chachaboolean nullable

Response

Successful Response

{"stackTrail":"paths:/chatrooms/{room_name}/breakouts:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

Changed in 2 of the 25 revisions of this API.2

Sep 21, 202613996d792e231See the full diff
- ○
  added the new optional request property
  new-optional-request-property
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 5, 2026b4e00183a0a21See the full diff
- ○
  added the new optional request property
  new-optional-request-property

Of the 25 revisions, 1 has no diff computed.

Full history