> ## Documentation Index
> Fetch the complete documentation index at: https://docs.boson.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Report issues and share feedback

> Where to report bugs, bad output, latency, docs problems, and feature requests for Boson AI products.

Report problems and suggestions as issues in the [Boson Feedback Collection](https://github.com/boson-ai/Boson-Feedback-Collection) repository on GitHub. Every issue is triaged by the Boson team, and you can follow its status on the issue itself. You need a GitHub account to file one.

> [!WARNING]
>
> The repository is **public**. Never paste API keys (`bai-...`), client secrets, tokens, or private data into an issue, a log, or an attachment. Redact them before posting.

## Pick a form

Each form takes about two minutes. Only product, severity, what happened, and how to reproduce are required; partial information is better than none, and any language is fine.

> **[Higgs Realtime problem](https://github.com/boson-ai/Boson-Feedback-Collection/issues/new?template=bug-realtime.yml)**
>
> Dropped sessions, turn detection, interruptions, tool calls, audio quality, or latency.

> **[Higgs TTS problem](https://github.com/boson-ai/Boson-Feedback-Collection/issues/new?template=bug-tts.yml)**
>
> Mispronunciations, cut-off audio, voice cloning, tags, or latency.

> **[Higgs Avatar problem](https://github.com/boson-ai/Boson-Feedback-Collection/issues/new?template=bug-avatar.yml)**
>
> Failed video jobs, lip-sync or visual artifacts, streaming, or realtime avatar sessions.

> **[Something else](https://github.com/boson-ai/Boson-Feedback-Collection/issues/new?template=bug-other.yml)**
>
> API keys, the workspace, these docs, or anything that doesn't fit a product.

> **[Feature request or feedback](https://github.com/boson-ai/Boson-Feedback-Collection/issues/new?template=feature-feedback.yml)**
>
> Ideas, missing features, or general impressions of a product.

> **[Browse existing issues](https://github.com/boson-ai/Boson-Feedback-Collection/issues)**
>
> Check whether someone already reported it. Add a 👍 or your details to the existing issue.

## What to include

The fastest reports to fix let us find your request in our logs and reproduce it:

* **Expected vs. actual.** One line each is enough.
* **A minimal reproduction.** The request body, a short script, or the steps you took.
* **Identifiers with timestamps**, including the timezone, so we can find the request on our side.
* **Environment.** Model name, SDK and version, endpoint, OS, and language.
* **Evidence.** Error bodies, logs, screenshots, or recordings. GitHub doesn't accept raw audio files, so zip `.wav` and `.mp3` files before you attach them.

Product-specific details that help:

| Product | Include |
| - | - |
| Higgs Realtime | The `session.id` from [`session.created`](https://docs.boson.ai/api-reference/realtime/server-events), the full [`error` event](https://docs.boson.ai/api-reference/realtime/server-events#error) or WebSocket close code, and your `session.update` config. |
| Higgs TTS 3 | The input text, `voice`, request parameters, and the output audio (zipped). |
| Higgs Avatar | The `video_id` or avatar `session_id`, the source image, and the driving audio or text. |
| Any API error | The full `error` object: `type`, `code`, and `message`. See [Common error types](https://docs.boson.ai/api-reference/errors.md). |

## Let your coding agent file it

Coding agents such as Claude Code, Codex, or Cursor can collect the details, redact secrets, and file the issue for you. Log in to the [GitHub CLI](https://cli.github.com/) first (`gh auth login`), then tell your agent:

```text theme={null}
Read https://raw.githubusercontent.com/boson-ai/Boson-Feedback-Collection/main/skills/report-boson-issue/SKILL.md
and follow it to report the problem I just hit.
```

The agent shows you the draft and files it only after you approve.

## What happens after you file

Every new issue is labeled `needs-triage`, and the Boson team updates the labels as it works on it. Watch the issue to get notified.

| Label | Meaning |
| - | - |
| `needs-triage` | New, not reviewed yet. |
| `needs-info` | We need more details. Reply on the issue. |
| `confirmed` | We reproduced it. |
| `duplicate` | Already reported. We link the original issue. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.