Personas & audiences
Create, ground, test and query the synthetic audiences in a workspace, and generate reactions, grades and chat.
Get audience group ordering
Return the workspace's audience groups with custom sort order.
Add one audience category
Append a single audience category without touching the rest of the list.
Update audience group ordering
Bulk update audience groups (sort order + optional rename).
Get or generate audience category summary
Return a synthesized audience-level summary for a persona category.
Get cached grades for multiple audience categories
Return cached grade + trend for all (or specified) audience categories in one call.
Queue audience cache refresh job
Queue a background job to proactively regenerate all audience category
Include or exclude an executive's voice in content creation
The per-executive voice toggle Body:
Executive content-creation voices for this workspace
State of every executive voice persona in the workspace
Get or generate a single-persona reaction summary
Synthesized summary for ONE persona — the favorites-card analogue of the
Get all personas
Get persona templates for the current workspace, optionally filtered by category.
Create persona
Create a new persona template
Generate persona avatar image
Disabled Avatar generation was the last un-US-pinnable LLM path.
Upload persona avatar image
Upload an avatar image for personas and return a usable avatar URL.
Build personas in the background
Queue one PERSONA_BUILD job per requested audience and kick each at once.
Bulk create personas
Bulk create persona templates for the current workspace.
Apply a reviewed tuning proposal to many personas
Apply per-persona field updates in one batch, with a per-persona report.
Get persona categories
Get all persona categories for the current workspace, sorted by custom order when available.
Persona chat onboarding and prompt coaching
Stateless chat endpoint for persona onboarding and prompt coaching.
Real-world event auto-test results across the workspace
Workspace-wide ledger of real-event persona auto-tests
Generate persona draft fields
Generate persona fields from partial inputs.
Get grade timeline for personas by period
Return grade per persona per time period for the breakdown chart.
Interact with persona
Interact with a synthetic persona
Get persona interactions
Get persona interactions, optionally filtered by persona
Get persona interaction
Get persona interaction results
Preview compiled persona prompt payload
Return the exact system/user prompt payload that would be sent to the LLM.
List cached persona reaction insights
List cached persona reaction insights for the current workspace.
Get or generate cached persona reaction insights
Return cached persona reaction insights for a document/persona set.
Queue a background job to generate persona reaction insights
Queue a background job for generating persona reaction insights and return
Get reaction history for a persona+document pair
Return chronological reaction entries for a single persona + document,
Generate/fetch grounded 'why this matters' for a persona+document
Grounded retrieval pass surfacing why a communication matters to a specific
Why-this-matters availability + auto setting
Return whether the grounded 'Why this matters to them' section is available
Delete persona
Delete a persona template
Get persona by ID
Get a specific persona template
Update persona
Update an existing persona template
Analyze voice from writing samples
Analyze writing samples to extract a structured voice profile for a persona.
Enable/disable auto-testing this persona against real events
Set the per-persona real-event auto-test opt-in Body:
Discover LinkedIn profile for persona
Find LinkedIn profile candidates for a persona from real search results.
Trigger a persona drift check now
Enqueue a PERSONA_DRIFT_CHECK job for a single persona (re-run golden
Confirm a drift check (response fine)
Confirm-or-tune → CONFIRM: the current response is fine, so promote it to
Mark a drift check as being tuned
Confirm-or-tune → TUNE: the response has drifted; mark the check resolved
Get persona drift-check cadence
Return the effective drift-check cadence (override or workspace default).
Set persona drift-check cadence override
Set (or clear) the per-persona drift-check cadence override. Body:
Submit persona response feedback
Submit feedback for a persona response (thumbs up/down + description).
Generate content in persona voice
Generate multi-format content (press release, blog post, social media, email,
List persona golden responses
List golden-set entries (trusted prompt/response baselines) for a persona.
Add a golden response
Add a golden-set entry.
List seed-from-feedback candidates
List positive feedback items eligible to seed the golden set.
Delete a golden response
Delete a golden-set entry.
Update a golden response
Edit prompt/response or activate/deactivate a golden-set entry.
Get persona health + latest drift checks
Return a persona's rolling health state, drift cadence, and the latest
Get a persona's intelligence snapshots
Return a persona's synthesized snapshots plus its measured corpus facts.
Link external source to persona
Link an external source (e.g. a journalist's column, a blog, or a publication URL)
Link an uploaded file to persona
Upload a file (deck, doc, notes) and link it to a persona as a grounding
Link LinkedIn profile to persona
Link a LinkedIn profile to a persona by creating a knowledgebase with a
Quick-add a persona link
Append one pasted profile or website URL to a persona's links
List persona refinements
List all active refinements (tuning notes) for a persona.
Add manual persona refinement
Manually add a refinement note to a persona profile.
Delete persona refinement
Delete a refinement note from a persona profile.
Update persona refinement
Update content or active state of a refinement note.
Trigger a persona refresh now
Enqueue a PERSONA_REFRESH job for a single persona (re-crawl linked KBs,
Trigger persona intelligence synthesis now
Enqueue a PERSONA_INTELLIGENCE job for a single persona.
Get persona refresh cadence policy
Return the effective refresh cadence for a persona (override or workspace default).
Set persona refresh cadence override
Set (or clear) the per-persona refresh cadence override.
Adopt a marketplace source into an existing persona
Point an existing workspace persona at a marketplace catalog row
Get persona self-healing auto-tune policy
Return the per-persona self-healing auto-tune policy
Set persona self-healing auto-tune policy
Turn self-healing auto-tune on or off for one persona
Unlink an uploaded file from persona
Remove a linked file from a persona: detach the document from the
List voice profiles for a persona
Return all voice profiles for a persona.
Delete a voice profile
Delete a voice profile. Cannot delete the last remaining profile.
Get a single voice profile
Return a single voice profile by ID.
Update a voice profile
Update an existing voice profile (name, adjective_tags, tone_pillars, etc.).
Set default voice profile
Set a voice profile as the default for content generation.
Translate persona output into the operator language
Translate a persona reaction row, or a single string, for the operator.
Get per-family health-check toggles + cost
Return every check family, its declared cost, and this workspace's opt-in.
Set per-family health-check toggles
Enable or disable individual check families for this workspace.
Get workspace default persona refresh cadence
Return the workspace-level default refresh cadence (falls back to quarterly).
Set workspace default persona refresh cadence
Set the workspace-level default refresh cadence (marquee/default personas