---
title: "Suggest a short title for a transcribed voice note"
method: POST
path: "/voice/suggest-title"
tags: ["voice"]
---

# Suggest a short title for a transcribed voice note

`POST /voice/suggest-title`

## Request

- Base URL: `https://api.focusbear.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.focusbear.io/voice/suggest-title`
- Auth: HTTP bearer

Always 200 for a valid transcript; `title` is null when no title could be suggested.

## Request body

- VoiceSuggestTitleDto
  - `text` string, required: The whole transcript of a voice note: the `text` of every `POST /voice/transcribe` chunk, joined. Send only the transcript, not other text already in the note.

## Response `200`

- VoiceSuggestTitleResponseDto
  - `title` string, nullable, required: A short title in the transcript's language (at most 60 characters, no quotes, no trailing punctuation), or null when none could be suggested. Clients keep their own title when it is null.

---

[API](https://skmtc.dev/focusbear/apis/focusbear-api.md) - [All operations](https://skmtc.dev/focusbear/apis/focusbear-api/llms.txt) - [OpenAPI document](https://skmtc.dev/focusbear/apis/focusbear-api/revisions/3a83a3b9a811?raw)