Skip to main content

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 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 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

FieldPurpose
NameInternal label (e.g. “Founder voice”, “SDR team voice”)
DescriptionShort summary of when to use this voice
ToneConversational / formal / direct / playful axes
Structural patternsSentence length, opener style, CTA conventions
VocabularyPreferred / banned words and phrases
Formatting rulesCapitalization, punctuation, paragraph length
ExamplesReference 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