/worlds/:id/residentsmemberThe selves who live in this world.
API ยท 24 operations
Make a world, populate it, run it, step it, jump it, branch it, replay it, and open any life in it.
/worlds/:id/residentsmemberThe selves who live in this world.
/worldsadminMake a world in this project's universe. With no pack it is a place selves live in (kind optional: its seed is the world's first state). With a pack it also holds a living population: members drawn from a pack go on over simulated time (households, ties, circles, followers, life events from event_process dimensions, word of mouth, fatigue, bounded memory). Created paused at tick 0; the reply carries the plan (see /worlds/:id/plan).
Body
kind | a kind declared at PUT /universe/kinds/:id (optional) |
name | text |
pack | the pack |
population | {simulate: 2..20000 members, represents?, seed?, segments?, mixing?}, or {personas: {handles? | where?, limit?, copies?}, seed?}: a world made only of personas may hold one member (a persona world: one life on the world's clock, no ties to others); see the note persona_world |
stimulus | {text, kind?}: what members meet and are voiced about |
stimuli | [{key, label?, text?, kind?, channels?, images?: [at most 4 base64 data: URLs, each under 400,000 characters]}]: further stimuli on the timeline, named by an intervention's params.stimulus; their pictures go to the model with their words when a member is voiced on them, and are counted (pictures), not returned, when the world is read |
time | {start: YYYY-MM-DD, horizon: "30d", step?: "1d", resolution?: [{until, step}] (finer steps early), scale?: realtime|1h=1min|1h=1s|1d=1min|1d=10s|1d=1s|1w=1s|{sim, real}} |
feed | {channels: {name: rate/day}, imitation?, across?, fatigue?, fatigue_shape?, potential?: 0..1 the share who could ever take it up (the rest hear of it but never take it up)} |
social | {ties?, household?, influencers?, follows?, circles?: {by, size}, homophily?, pull?} |
life | {processes?: [event_process dims], budget?: scalar dim, age?: scalar dim} |
memory | {cap?: 1..64, reflect_days?, consolidate_days?} |
budget | {calls_per_day?: members voiced by the model per simulated day (the realism knob)} |
interventions | [{at, kind, label?, params?}] |
/worldsmemberWorlds, newest first: status (paused|running|done|failed), tick, parent and branch tick.
Query
status | paused|running|done|failed |
limit | 1..200 (50) |
/worlds/:idmemberOne world: spec, clock (tick, sim time, target), run (scale and whether it was capped), interventions, pending voiced members.
/worlds/:idadminDelete a world with its member states and log. Its branches stay (they no longer name a parent).
/worlds/:id/runadminRun the world in real time at its scale, capped to what the model and the arithmetic sustain (the reply says so). At most 3 running per tenant (429).
Body
scale | optional: a preset or {sim, real} |
calls_per_day | optional: members voiced per simulated day |
/worlds/:id/pauseadminPause a running world; idempotent.
/worlds/:id/stepadminAdvance a paused world by ticks (default 1) as fast as the arithmetic goes; voiced members still answer.
Body
ticks | 1..10000 |
/worlds/:id/jumpadminAdvance a paused world to a later time.
Body
to | a duration from the start ("14d"), seconds or a date |
/worlds/:id/branchadminBranch at a tick the world has reached (default now): the new world shares everything before it (re-simulated, with the recorded voices, no model calls) and goes on with its own interventions. The parent is untouched.
Body
at | tick |
name | text |
/worlds/:id/planmemberFeasibility: the requested and effective (capped) scale, what limits it (model or arithmetic), model calls per second needed, estimated real time to the horizon, model calls to the horizon, and a plain sentence.
Query
scale | a preset or sim=real |
calls_per_day | members voiced per simulated day |
/worlds/:id/replaymemberThe world's log, tick by tick: aggregates (have_it, aware, opinion, new adopters, exposures, life events, daily circle tiles), up to 25 sampled events per tick, group leanings.
Query
from | tick |
to | tick |
limit | 1..2000 (500) |
events | false to leave events out |
/worlds/:id/membersmemberMembers, paged, at the current or an earlier tick: public traits (aggregate-only dimensions withheld), household, circle, awareness, opinion.
Query
after | member index |
limit | 1..500 (100) |
tick | a reached tick |
/worlds/:id/members/:imemberOne member: as in the list, plus ties, memory (private life events withheld) and how they look (appearance: age, build, hair, skin, posture, visible energy and dress, each with what caused it; world spec appearance names which traits to read), the life events they went through (life), and what last changed each trait an event touched (causes: the event, or the trait whose change led to it, with its basis: measured and its reference, stated, definition or assumed).
Query
tick | a reached tick |
/worlds/:id/interventionsmemberThe world's interventions.
/worlds/:id/voicesmemberWhat members said (params.voice.notice lets a voiced member see the condition of things they use, in this or another of the tenant's worlds), in their own words: each answer with its date, member, persona, the intervention and stimulus it was about, and its rated measures; reflections; and each voiced moment (an intervention with params.voice) read as a whole per measure (rated, distribution, mean, share who would act). An answer to a moment measure is carried as moments: {key: {text, feel}} on the answer, and per voiced moment as moment_measures: {key: {answered, prompt, label?, feel_mean, answers}} (see the note moment_measures).
Query
member | a member index |
intervention | an intervention id |
after | a tick |
limit | 1..1000 (200) |
/worlds/:id/livesadminA defined self joins a world of lives: a persona (its age and gender, and its own words for the voice) or an age and sex take the place of the living life of that sex nearest that age; from then on it is advanced by the same hazards.
Body
persona | a persona handle |
age | years |
sex | female | male |
children | 0..20 |
partnered | boolean |
/worlds/:id/interventionsadminAdd an intervention while paused, at or after the current time (409 otherwise).
Body
at | duration from the start, seconds or a date |
kind | drop|campaign|outside|price|influencer|life |
label | text |
params | {exposure?, duration?, half_life?, who?, factor? (price), count? (influencer), member?, event? (life)} |
/worlds/:id/advanceadminA world of lives (made with POST /worlds {lives: {count, hazards, seed?, places?, year?}}): advance it {months: 1..1200} by its hazard table. Returns the world in aggregate: lives held and alive, the year, births, deaths and partnerships so far, and which hazards are measured and which are placeholders.
Body
months | 1..1200 |
/worlds/:id/lives/:lifememberMeet a life in a world of lives: its own record as it knows it (age, partner and for how long, children and their ages, whether it lives with its mother) and the same in its own words.
/worlds/:id/lives/:life/voiceadminA met life's voiced decision, written back. decision: birth (a woman), partner (forming a partnership), separate or leave (their parent's household), in the next months (default 12). The life answers through this tenant's model with its story as memory (and its own words when it is a defined persona); the world host anchors the answer to the population's hazard (a voice moves one life around the level, never sets it) and draws the outcome as a real event. An answer with no chance in it is did-not-run and changes nothing.
Body
decision | birth | partner | separate | leave |
months | 1..60 |
/worlds/:id/saveadminSave a world of lives to object storage, so it outlives the host's memory and comes back exactly.
/worlds/:id/interventions/:iidadminChange an intervention that has not happened yet, while paused.
/worlds/:id/interventions/:iidadminRemove an intervention that has not happened yet, while paused.

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