update_brand_voice

Patch a brand's voice guidelines — tone summary, style settings, and core tone traits.

Patch a brand's voice guidelines — the tone and style settings that steer how content is written. This is a partial update: only the fields you pass are changed; everything else is left as-is. Synchronous, no LLM call, no credit cost.

Use get_brand_voice first to see current values. To rebuild the whole voice from the knowledge base instead, use rebuild_brand_voice.

Authentication: Required

Parameters

Parameter	Type	Required	Description
`syntheticId`	`integer`	Yes	The agent whose brand voice to update.
`voiceSummary`	`string`	No	A summary of how the brand communicates — its tone, personality, and positioning.
`formalityLevel`	`enum`	No	Level of formality: `casual`, `neutral`, or `professional`.
`sentenceLength`	`enum`	No	Preferred sentence length: `short`, `medium`, or `long`.
`useOfEmojis`	`enum`	No	Emoji frequency: `never`, `sometimes`, or `often`.
`useOfHashtags`	`enum`	No	Hashtag strategy: `minimal`, `moderate`, or `strategic`.
`coreToneTraits`	`array`	No	Core tone traits (replaces the existing list). Each item is `{ trait, description }`.

Pass at least one field — an all-empty update is rejected. The four style enums are stored under styleGuide; passing only some leaves the rest of styleGuide untouched.

Response

{
  "success": true,
  "syntheticId": 1234,
  "brandVoice": {
    "voiceSummary": "Confident but approachable. Technical depth without jargon.",
    "coreToneTraits": [
      { "trait": "Authoritative", "description": "Speaks with earned confidence." }
    ],
    "styleGuide": {
      "formalityLevel": "professional",
      "sentenceLength": "medium",
      "useOfEmojis": "never",
      "useOfHashtags": "minimal"
    }
  }
}

Parameters

Response

On this page