---
title: "Transcribe Widget Spoken Audio"
method: POST
path: "/api/v1/public/text-widget/sessions/{session_id}/transcribe"
---

# Transcribe Widget Spoken Audio

`POST /api/v1/public/text-widget/sessions/{session_id}/transcribe`

## Request

- Base URL: `https://api.getanana.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getanana.com/api/v1/public/text-widget/sessions/{session_id}/transcribe`
- Auth: none declared. Required headers: `X-Session-Token`

Transcribe a visitor clip. Auth is the same session token as chat.

## Path parameters

- `session_id` string, uuid, required

## Headers

- `X-Session-Token` string, required

## Request body `multipart/form-data`

- BodyTranscribeWidgetSpokenAudioApiV1PublicTextWidgetSessionsSessionIdTranscribePost
  - `file` string, binary, required

## Response `200`

Successful Response

- SpeakToChatTranscriptRead: Transcript of a short browser-recorded clip. ``text`` is empty when Deepgram heard no speech. The composer stays usable; the client shows a clear 'couldn't hear anything' error rather than sending an empty message.
  - `text` string, required

## Other responses

- `400`: Empty, oversized, or unsupported audio
- `401`: Invalid session token
- `410`: Session has ended
- `422`: Validation Error
- `429`: Too many requests
- `502`: Speech-to-text provider failed
- `503`: Speech-to-text is not configured

## Changes

> 55 revisions in range; 1 not diffed.

- **2026-09-03** `d65b8fefae34`: 1 breaking, 3 info
  - the `file` request property contentMediaType changed from `` to `application/octet-stream`
  - the `file` request property format was generalized from `binary` to no format
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Operation history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/public/text-widget/sessions/:session_id/transcribe/post.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/4d9d38769a75?raw)