Skip to main content
Personas are the individual AI consumers generated within a persona group. Each persona has a consistent identity, backstory, and cultural grounding that persists across every simulation you run. They represent specific, believable people — not demographic averages. All persona endpoints are nested under a project and persona group: /api/v1/projects/{project_id}/persona-groups/{group_id}/personas

​
Endpoints

MethodPathAuthDescription
GET.../personasYesList all personas in a group
GET.../personas/{persona_id}YesGet a single persona
DELETE.../personasYesDelete all personas in a group
DELETE.../personas/{persona_id}YesDelete a single persona

​
GET /personas

List all personas generated within a persona group. Returns an array of persona objects.

​
Path parameters

​
project_id
string
required
UUID of the parent project.
​
group_id
string
required
UUID of the persona group.

​
Example

curl https://api.temujintechnologies.com/api/v1/projects/3fa85f64-5717-4562-b3fc-2c963f66afa6/persona-groups/b2c3d4e5-0000-0000-0000-000000000010/personas \
  -H "Authorization: Bearer <access_token>"

​
GET /personas/

Retrieve a single persona by its ID.

​
Path parameters

​
project_id
string
required
UUID of the parent project.
​
group_id
string
required
UUID of the persona group.
​
persona_id
string
required
UUID of the persona.

​
Response fields

​
id
string
UUID of the persona.
​
full_name
string
The persona’s full name, e.g. "Maria Santos".
​
age
number
Age in years.
​
gender
string
Gender identity.
​
occupation
string
Job title or professional role.
​
location
string
City and country.
​
income_level
string
Income bracket: "Low", "Middle", or "High".
​
personality_traits
string[]
A list of 3–5 personality descriptors that influence how this persona responds in simulations.
​
trusted_brands
string[]
Brands this persona has a positive relationship with. Used to calibrate brand-adjacent responses.
​
distrusted_brands
string[]
Brands this persona is skeptical of or has had negative experiences with.
​
digital_habits
string
A narrative description of how this persona uses digital platforms, apps, and payment methods.
​
price_sensitivity
string
A narrative description of this persona’s relationship with price and value trade-offs.
​
psychographic_notes
string
Deeper motivations, aspirations, and behavioral patterns that inform this persona’s responses.
​
avatar_url
string
URL of the AI-generated profile image for this persona.
​
library_persona_id
string
If this persona was sourced from the Persona Library, this field contains the library persona’s UUID. null if this persona was generated fresh.
​
created_at
string
ISO 8601 UTC timestamp of when the persona was generated.

​
Example

curl https://api.temujintechnologies.com/api/v1/projects/3fa85f64-5717-4562-b3fc-2c963f66afa6/persona-groups/b2c3d4e5-0000-0000-0000-000000000010/personas/c3d4e5f6-0000-0000-0000-000000000020 \
  -H "Authorization: Bearer <access_token>"

​
DELETE /personas

Delete all personas in a persona group. Use this to clear the group before regenerating.
Deleting personas from a group does not affect simulation results that have already been recorded — past responses are preserved in the simulation results.

​
Path parameters

​
project_id
string
required
UUID of the parent project.
​
group_id
string
required
UUID of the persona group whose personas you want to delete.

​
Example

curl -X DELETE https://api.temujintechnologies.com/api/v1/projects/3fa85f64-5717-4562-b3fc-2c963f66afa6/persona-groups/b2c3d4e5-0000-0000-0000-000000000010/personas \
  -H "Authorization: Bearer <access_token>"

​
DELETE /personas/

Delete a single persona from the group.

​
Path parameters

​
project_id
string
required
UUID of the parent project.
​
group_id
string
required
UUID of the persona group.
​
persona_id
string
required
UUID of the persona to delete.

​
Example

curl -X DELETE https://api.temujintechnologies.com/api/v1/projects/3fa85f64-5717-4562-b3fc-2c963f66afa6/persona-groups/b2c3d4e5-0000-0000-0000-000000000010/personas/c3d4e5f6-0000-0000-0000-000000000020 \
  -H "Authorization: Bearer <access_token>"

​
Personas and the library

High-performing personas — those that produce consistent, non-contradictory responses across multiple simulations — are eligible for promotion to the Persona Library. Library personas can be reused across projects, enabling longitudinal studies where you track attitude shifts in the same individuals over time. When a persona was sourced from the library, the library_persona_id field contains its library UUID. This lets you trace which library persona underlies a given project persona and find all projects that have used the same individual.