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

# Preview Breakouts

`POST /chatrooms/{room_name}/breakouts/preview`

Compute the proposed breakout assignment WITHOUT creating any rooms, so the
teacher can see who's in each room and adjust before starting. Host only.

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

> 25 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/preview/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/be75c0eba493?raw)