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

# What is Brand Voice in Octave?

> Brand Voice captures your company's distinctive writing style — tone, structure, vocabulary, formatting — and applies it consistently to every piece of generated content.

## What is a Brand Voice?

A Brand Voice is a structured profile of how your company writes — the tone, sentence rhythm, structural patterns, vocabulary, formatting conventions, and stylistic do's and don'ts that make your emails, posts, and outbound messaging sound recognizably *yours*. Without a Brand Voice, every agent output reverts to generic LLM cadence. With one, the same prompt produces output that reads like it came from someone on your team.

You can have multiple Brand Voices in a workspace (e.g. one for the founder, one for the SDR team, one for a specific product line) and apply a different voice per agent or per request.

## How Brand Voices are created

Three paths:

1. **Generate from samples** — paste real emails, posts, or copy you've written. The `POST /api/v2/brand-voice/generate` endpoint analyzes the corpus and produces a voice profile (tone, patterns, vocabulary, structure rules).
2. **Manually create** — build a voice profile from scratch via `POST /api/v2/brand-voice/create` with your own descriptors.
3. **Capture from LinkedIn** — the `capture-voice` and `capture-company-voice` MCP skills fetch posts via MixRank and analyze them into a saved voice profile.

## How agents use Brand Voice

When an agent generates content — Sequence, Content, Call Prep — it can read a Brand Voice and condition the output on the voice's patterns. You select which voice applies via:

* **Default voice** — set a workspace default via `POST /api/v2/brand-voice/toggle-default`. Agents fall back to this when no voice is specified.
* **Per-agent** — a saved [Agent](/concepts/agents) can be configured with a specific Brand Voice.
* **Per-request** — pass a `brandVoiceOId` in the agent's request body to override for a single call.

The `POST /api/v2/brand-voice/apply` endpoint runs a one-shot rewrite — paste text in, get the same text in your voice out. Useful for editing existing drafts without running a full agent.

## What a Brand Voice contains

| Field               | Purpose                                                 |
| ------------------- | ------------------------------------------------------- |
| Name                | Internal label (e.g. "Founder voice", "SDR team voice") |
| Description         | Short summary of when to use this voice                 |
| Tone                | Conversational / formal / direct / playful axes         |
| Structural patterns | Sentence length, opener style, CTA conventions          |
| Vocabulary          | Preferred / banned words and phrases                    |
| Formatting rules    | Capitalization, punctuation, paragraph length           |
| Examples            | Reference samples the voice was trained from            |

## Managing Brand Voices via API

* `GET /api/v2/brand-voice/list` — list voices
* `GET /api/v2/brand-voice/get` — get a specific voice
* `POST /api/v2/brand-voice/create` — create a voice manually
* `POST /api/v2/brand-voice/generate` — generate a voice from samples
* `POST /api/v2/brand-voice/update` — update a voice
* `POST /api/v2/brand-voice/apply` — rewrite arbitrary text in a voice
* `POST /api/v2/brand-voice/toggle-default` — set the workspace default voice