---
title: "Create Breakouts"
method: POST
path: "/chatrooms/{room_name}/breakouts"
tags: ["chatrooms"]
---

# Create Breakouts

`POST /chatrooms/{room_name}/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.

## Path parameters

- `room_name` string, required

## Headers

- `authorization` string, nullable

## Request body

- CreateBreakoutsRequest
  - `task` string, nullable
  - `num_rooms` integer, nullable
  - `group_size` integer, nullable
  - `assignments` array[], nullable
    - string[]
  - `half_minutes` integer, nullable
  - `duration_minutes` integer, nullable
  - `language_a` string, nullable
  - `language_b` string, nullable
  - `hosted_by_chacha` boolean, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

> 24 revisions in range; 1 not diffed.

- **2026-09-21** `13996d792e23` — 1 info
  - added the new optional request property `hosted_by_chacha`
- **2026-09-05** `b4e00183a0a2` — 1 info
  - added the new optional request property `task`

[Change history](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/changes/chatrooms/:room_name/breakouts/post.md)

---

[API](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored.md) · [All operations](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/llms.txt) · [OpenAPI document](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/revisions/ecd3f19d9e8b?raw)