Personas
Create, ground and query the synthetic personas in a workspace: interact, summarise, write in their voice.
Get all personas
Get persona templates for the current workspace, optionally filtered by category.
Create persona
Create a new persona template
Interact with persona
Put a question, a draft or a workspace document in front of one persona and get its reply. Replies take 10 to 30 seconds. For a whole audience at once use `POST /api/v1/personas/reaction-insights`.
Generate/fetch grounded 'why this matters' for a persona+document
Why this document matters to one persona: a web-grounded note with sources, cached for 7 days. `POST /api/v1/audiences/reactions` returns the same note on every reaction when its `include` lists `why_it_matters`; call this route to fetch one on its own or to regenerate it with `force_refresh`.
Delete persona
Delete a persona template
Get persona by ID
Get a specific persona template
Update persona
Send only the fields to change.
Analyze voice from writing samples
Analyze writing samples to extract a structured voice profile for a persona.
Submit persona response feedback
Submit feedback for a persona response (thumbs up/down + description).
Generate content in persona voice
Write a piece in the persona's voice. The draft is saved as a workspace document.
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
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.
Get or generate a persona summary
What one persona thinks, summarised from its recent reactions.
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.