System
Responses
Models
Personas
Custom Personas
Brand Voice
Generations
Mave
Workspaces
Meetings
Files
Video Analysis
News
Create brand voice
Create a new brand voice by providing source materials (URLs and/or documents). The AI will analyze the content and generate a brand voice profile. Processing happens asynchronously - poll the GET endpoint to check status.
curl -X POST https://app.mavera.io/api/v1/brand-voices \
-H "Authorization: Bearer mvra_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"label": "Acme Brand Voice",
"urls": ["https://acme.com/about", "https://acme.com/blog"],
"usage_context": "Marketing content and social media"
}'{
"id": "<string>",
"object": "brand_voice",
"label": "<string>",
"usage_context": "<string>",
"status": "pending",
"error": "<string>",
"voice_summary": "<string>",
"tone": {
"adjectives": [
"<string>"
],
"dos": [
"<string>"
],
"donts": [
"<string>"
]
},
"writing_style": {
"sentence_structure": "<string>",
"jargon_usage": "<string>"
},
"vocabulary": {
"preferred_terms": [
"<string>"
],
"avoid_terms": [
"<string>"
]
},
"example_phrases": [
{
"use_case": "<string>",
"example": "<string>"
}
],
"sources": {
"urls": [
{
"id": "<string>",
"url": "<string>",
"name": "<string>",
"description": "<string>"
}
],
"documents": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"file_type": "<string>",
"file_size": 123
}
]
},
"workspace_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}Authorizations
API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.
Body
Display name for the brand voice
2Description of how this brand voice will be used
10Target workspace ID (uses default workspace if not specified)
URLs to analyze for brand voice extraction
Show child attributes
Show child attributes
Documents to analyze for brand voice extraction
Show child attributes
Show child attributes
Example phrases you want the brand voice to use
Show child attributes
Show child attributes
Vocabulary preferences
Show child attributes
Show child attributes
Tone preferences
Show child attributes
Show child attributes
Response
Brand voice created successfully. Status will be 'pending' until processing completes.
A brand voice profile for content generation
Unique brand voice identifier
brand_voice Display name for the brand voice
Description of how this brand voice should be used
Current processing status of the brand voice
pending, generating, completed, failed Error message if status is failed
AI-generated summary of the brand voice
Tone guidelines for the brand voice
Show child attributes
Show child attributes
Writing style guidelines
Show child attributes
Show child attributes
Vocabulary preferences
Show child attributes
Show child attributes
Example phrases demonstrating the brand voice
Show child attributes
Show child attributes
Source materials used to generate the brand voice
Show child attributes
Show child attributes
curl -X POST https://app.mavera.io/api/v1/brand-voices \
-H "Authorization: Bearer mvra_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"label": "Acme Brand Voice",
"urls": ["https://acme.com/about", "https://acme.com/blog"],
"usage_context": "Marketing content and social media"
}'{
"id": "<string>",
"object": "brand_voice",
"label": "<string>",
"usage_context": "<string>",
"status": "pending",
"error": "<string>",
"voice_summary": "<string>",
"tone": {
"adjectives": [
"<string>"
],
"dos": [
"<string>"
],
"donts": [
"<string>"
]
},
"writing_style": {
"sentence_structure": "<string>",
"jargon_usage": "<string>"
},
"vocabulary": {
"preferred_terms": [
"<string>"
],
"avoid_terms": [
"<string>"
]
},
"example_phrases": [
{
"use_case": "<string>",
"example": "<string>"
}
],
"sources": {
"urls": [
{
"id": "<string>",
"url": "<string>",
"name": "<string>",
"description": "<string>"
}
],
"documents": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"file_type": "<string>",
"file_size": 123
}
]
},
"workspace_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}