GET/personasmember
The tenant's personas (current versions), filtered by any dimension of a pack. Special-category values are withheld and cannot be filtered on here.
Query
pack | pack key (needed to filter) |
where | JSON {dimension key: value | {in: [..]} | {gte|lte|gt|lt: n} (scalars) | {has: item} (sets) | {exists: bool}} |
self | voiced by this self |
limit | 1..1000 (100) |
after | handle to page after |
retired | 1 to include retired |
POST/personasadmin
Create a persona: values validated against its pack's dimensions; about is who they are in their own words, read by the voice before their traits (a persona linked to a self speaks in the self's words and character, and its about is the story of the life the self has lived).
Body
real_person | true when the persona stands for a real person (the consented route; added in contract version 1, additive) |
consent_ref | the id of that person's consent record (required with real_person) |
likeness_allowed | true when the person consented to their likeness being drawn |
deceased | true when the person has died |
handle | |
pack | |
values | {dimension key: value} |
about | free text, at most 4000 characters |
grounding | demographic | persona (default) | evidence (provenance required) |
provenance | {source, ...} |
self | handle of the self that voices it |
GET/personas/aggregatemember
Counts per group of a category, set or mixing-group dimension, with mean/min/max of a scalar measure. When a special-category dimension is involved, groups under 10 are suppressed.
Query
pack | |
by | dimension key |
measure | scalar dimension key |
where | JSON {dimension key: value | {in: [..]} | {gte|lte|gt|lt: n} (scalars) | {has: item} (sets) | {exists: bool}} |
GET/personas/exportmember
Export a pack's personas as JSON or CSV text (special-category values withheld).
Query
pack | |
format | json | csv |
where | JSON {dimension key: value | {in: [..]} | {gte|lte|gt|lt: n} (scalars) | {has: item} (sets) | {exists: bool}} |
POST/personas/importadmin
Import personas from CSV (header: handle, grounding?, dimension keys; sets as a|b, JSON cells allowed) or JSON (a list). Good rows are written, bad rows reported per row with their faults; dryRun writes nothing.
Body
pack | |
format | csv | json |
data | CSV text or a list of personas |
grounding | default for rows |
provenance | default for rows |
dryRun | boolean |
GET/personas/:handle/memoriesmember
What a persona remembers and said, with the words, across the worlds it lived in (newest first): each world's dated memories (private ones withheld) and voices, and which of its copies.
Query
world | only this world |
limit | 1..2000 (500) |
GET/personas/:handlemember
A persona at a version (?version=, default current) and its versions. Special-category values are withheld.
PUT/personas/:handleadmin
Write a persona's next version (re-validated against its pack's latest version). merge keeps values not named; self links (or null unlinks) the self that voices it.
Body
values | |
merge | boolean |
pack | |
grounding | |
provenance | |
self | handle or null |
DELETE/personas/:handleadmin
Retire a persona. Its versions stay readable. With purge=1 (added in contract version 1, additive) every version is removed and its words and memories are cleared from the worlds it lived in, with a receipt in the erasure chain: a dry run lists what would go; send confirm equal to the handle to do it. For a persona that stood for a real person.
Query
purge | 1 to remove every version and clear its words from worlds |
confirm | the handle, with purge=1, for the real removal |
POST/personas/:handle/daysmember
Live one planned day ahead as this persona, as POST /selves/:handle/days (nothing is recorded on a persona). A persona that stands for a real person needs its consent reference; the project's content policy applies. Added in contract version 1, additive.
Body
date | YYYY-MM-DD |
place | optional |
stops | [{at: HH:MM, title, text, place?, images?}] |
conditions | optional text |
estimate_only | true for the cost only |