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

packpack key (needed to filter)
whereJSON {dimension key: value | {in: [..]} | {gte|lte|gt|lt: n} (scalars) | {has: item} (sets) | {exists: bool}}
selfvoiced by this self
limit1..1000 (100)
afterhandle to page after
retired1 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_persontrue when the persona stands for a real person (the consented route; added in contract version 1, additive)
consent_refthe id of that person's consent record (required with real_person)
likeness_allowedtrue when the person consented to their likeness being drawn
deceasedtrue when the person has died
handle
pack
values{dimension key: value}
aboutfree text, at most 4000 characters
groundingdemographic | persona (default) | evidence (provenance required)
provenance{source, ...}
selfhandle 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
bydimension key
measurescalar dimension key
whereJSON {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
formatjson | csv
whereJSON {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
formatcsv | json
dataCSV text or a list of personas
groundingdefault for rows
provenancedefault for rows
dryRunboolean
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

worldonly this world
limit1..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
mergeboolean
pack
grounding
provenance
selfhandle 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

purge1 to remove every version and clear its words from worlds
confirmthe 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

dateYYYY-MM-DD
placeoptional
stops[{at: HH:MM, title, text, place?, images?}]
conditionsoptional text
estimate_onlytrue for the cost only
A glass tree whose crown holds many small worlds like fruit

Which world will you live in?

What grows here is meant to reach the real world. Start with a world of your own.