---
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
  - `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

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[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-service-production.skmtc.workers.dev/v1/apis/fluentea/aurqa-language-learning-platform-refactored/revisions/78f314acd8bf/schema)
