Update Voice
Partially updates an existing Voice. Every field except id is optional and only the fields actually present in the request are written — an omitted field keeps its stored value, so updating the background group never clears the tone group and vice versa. Pass an empty string to clear a text field explicitly. Changes take effect immediately — the next comment or direct-message generation uses the updated values.
Authorizations
API Key for authentication
Path Parameters
Body
ID of the Voice to update.
New Voice name. Omit to keep the current one.
1Free-form plain text about the user themselves — role, background, perspective. Used as background when generating comments and direct messages, and when analyzing incoming posts. Omit to keep the current value; pass an empty string to clear it.
Free-form plain text about the user's company, product, market, and target audience. Used as background when generating comments and direct messages, and when analyzing incoming posts. Omit to keep the current value; pass an empty string to clear it.
Free-form plain text with tone instructions for comment generation (tone, structure, do/don't). Used only when generating comments, not direct messages. Omit to keep the current value; pass an empty string to clear it.
Free-form plain text with tone instructions for direct-message generation (tone, structure, do/don't). Used only when generating direct messages, not comments. Omit to keep the current value; pass an empty string to clear it.
Whether the Voice is in learning mode. When true, the backend auto-saves as Comment Examples only those comments the user both approved AND edited before approval (unchanged auto-approved comments are NOT saved). Only comments are learned — direct messages are never auto-saved. The Voice's Comment Examples are capped at 20 entries; auto-saved and manual entries share the same 20-slot cap. When false, no auto-learning happens and existing Comment Examples keep being used as-is. Omit to keep the current value.