Skip to main content

​
Overview

Brand Voice API lets you create and manage brand voice profiles that ensure consistent tone across all AI-generated content. Upload URLs and documents, and AI generates tone guidelines, vocabulary preferences, and writing style recommendations.

​
Creating a Brand Voice

import requests

response = requests.post(
    "https://app.mavera.io/api/v1/brand-voices",
    headers={"Authorization": "Bearer mvra_live_your_key_here"},
    json={
        "label": "Main Brand Voice",
        "usage_context": "Marketing content and customer communications",
        "urls": [
            "https://yourbrand.com/about",
            "https://yourbrand.com/blog"
        ],
        "workspace_id": "your_workspace_id"
    }
)

brand_voice = response.json()
print(f"Brand Voice ID: {brand_voice['id']}")
print(f"Status: {brand_voice['status']}")

​
Brand Voice Profile

Once processed, a brand voice includes: 
{
  "id": "bv_abc123",
  "label": "Main Brand Voice",
  "status": "READY",
  "voice_summary": "Confident yet approachable, with a focus on empowering customers...",
  "tone_adjectives": ["confident", "friendly", "innovative", "trustworthy"],
  "tone_dos": [
    "Use active voice",
    "Address the reader directly",
    "Include concrete examples"
  ],
  "tone_donts": [
    "Avoid jargon",
    "Don't be overly formal",
    "Never use passive aggressive language"
  ],
  "preferred_terms": ["customers", "solutions", "empower"],
  "avoid_terms": ["users", "problems", "cheap"],
  "sentence_structure": "Mix of short punchy sentences and longer explanatory ones"
}

​
Using Brand Voice in Generations

response = requests.post(
    "https://app.mavera.io/api/v1/generations",
    headers={"Authorization": "Bearer mvra_live_your_key_here"},
    json={
        "app_id": "blog_post_generator",
        "brand_voice_id": "bv_abc123",
        "input_data": {
            "topic": "Product Launch Announcement",
            "key_points": ["New features", "Pricing", "Availability"]
        },
        "workspace_id": "your_workspace_id"
    }
)

​
List Brand Voices

curl https://app.mavera.io/api/v1/brand-voices \
  -H "Authorization: Bearer mvra_live_your_key_here"

​
Set Default Brand Voice

response = requests.patch(
    f"https://app.mavera.io/api/v1/brand-voices/{brand_voice_id}",
    headers={"Authorization": "Bearer mvra_live_your_key_here"},
    json={"is_default": True}
)

API Reference

See the full API specification