---
title: "Update Transcription State"
method: PUT
path: "/call/sessions/{call_session_id}/transcription-state"
tags: ["call", "calls"]
---

# Update Transcription State

`PUT /call/sessions/{call_session_id}/transcription-state`

Track when a user enables/disables transcription during a call.

This enables per-message privacy filtering based on when transcription was actually enabled.

Args:
    call_session_id: Call session ID (UUID or instant match session ID)
    user_id: User ID who is changing their transcription state
    enabled: Whether transcription is being enabled (True) or disabled (False)
    reason: Reason for change - "user_toggled", "quota_exceeded", "initial_setting"

🔒 Had zero auth dependency. This drives per-message privacy filtering
(whether a transcript line is retained), so an outsider who knew a
call_session_id could forge "transcription enabled" history for a call
they were never in. Now requires the caller to be an authenticated
participant of the session, and the recorded user_id is always the
caller's own id — a client-supplied user_id can no longer forge another
participant's transcription-state history.

## Path parameters

- `call_session_id` string, required

## Query parameters

- `user_id` string, required
- `enabled` boolean, required
- `reason` string

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-02** `45cbba31aa7d` — 1 info
  - added the new optional `header` request parameter `authorization`

[Change history](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/changes/call/sessions/:call_session_id/transcription-state/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-service-production.skmtc.workers.dev/v1/apis/fluentea/aurqa-language-learning-platform-refactored/revisions/ebade541eaa4/schema)