---
title: "Set Captions Mode"
method: PUT
path: "/chatrooms/{room_name}/captions-mode"
tags: ["chatrooms"]
---

# Set Captions Mode

`PUT /chatrooms/{room_name}/captions-mode`

## Request

- Base URL: `https://api.fluentea.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fluentea.com/chatrooms/{room_name}/captions-mode`
- Auth: none declared

Turn multilingual captions on or off. Host only.

On 2026-10-12 a live meeting needed three refreshes to start transcribing
its second language, because the stream decides its language when it
OPENS and nothing could change a stream that was already running. This
writes `activity_config.multilingual` (True, or False so it also beats a
class that is multilingual by default), which every stream opened from now
on reads, and tells everyone already in the call with a server-sent data
packet, `{"type": "captions_mode", "multilingual"}`. Each browser then
switches its own caption socket in place (`change_language`), so nobody
refreshes and no audio is dropped.

Open breakouts get the same flag and the same packet, as same-room mode
does. A room whose languages include one outside nova-3's multi set
(Chinese) is refused with 409 rather than silently left monolingual.

## Path parameters

- `room_name` string, required

## Headers

- `authorization` string, nullable

## Request body

- CaptionsModeRequest
  - `multilingual` boolean, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

> 48 revisions in range; 1 not diffed.

- **2026-10-13** `d4a0d0cc0665`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/changes/chatrooms/:room_name/captions-mode/put.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/aeb0298c02e1?raw)