/dimensionsmemberDeclared persona dimensions, latest version of each, platform and own; ?pack= narrows to one pack.
API ยท 4 operations
The forms a world can take.
/dimensionsmemberDeclared persona dimensions, latest version of each, platform and own; ?pack= narrows to one pack.
/dimensionsadminDeclare a dimension in one of the tenant's packs: its next version (an unchanged declaration writes nothing) and the pack's next version pinning it. Validated per type; every fault comes back at once in faults [{path, message}] (400). A dimension that plausibly duplicates an inherited one (the same key stem, e.g. age and age_band, or spec.refines naming it) is refused (409, faults at inherited.<key>) until the caller chooses: inherited: {<key>: {derive: fn}} makes the inherited dimension the pack's own, DERIVED from this one (never drawn, so members never contradict themselves), or {<key>: "keep"} keeps drawing both (recorded in spec.keeps). Examples per type: scalar {range: {min: 18, max: 90}, distribution: {kind: "normal", params: {mean: 40, sd: 12}}}; category {categories: [{label: "north", share: 0.4}, {label: "south", share: 0.6}]}; derived category {categories: ["under 30", "30+"], derived: {from: ["age"], fn: {kind: "band", of: "age", edges: [30], labels: ["under 30", "30+"]}}}; embedding {dims: 512}; set {items: ["vinyl", "streaming"], max_items: 2}; timeseries {of: "number", dynamics: {kind: "drift", rate: 0.01}}; edge {relation: "friend", structure: "mixing_group", homophily: ["region", "age_band"]}; event_process {process: "poisson", rate: {mean: 2, per: "month"}}.
Body
pack | your pack key |
key | lower_snake |
label | |
type | scalar | category | embedding | set | timeseries | edge | event_process |
inherited | {<inherited key>: {derive: {kind: band|lookup|arith, ...}} | "keep"} when this key duplicates an inherited one |
spec | {range: {min, max} (scalar) | categories: [label | {label, share}], open? (category) | dims: 1..4096 (embedding) | items?, max_items? (set) | of: number|category|vector|point|object, dims? (timeseries) | relation, structure: explicit|mixing_group, homophily: [dimension keys] (mixing_group edge), to?: persona|self|group (edge) | process: poisson|hawkes|scheduled|renewal, rate: {mean >= 0, per: day|week|month|year} (event_process); distribution?: {kind: normal {mean, sd} | lognormal {mu, sigma} | uniform | beta {a, b} | gamma {shape, rate} | poisson {lambda} | categorical {shares: {label: share}} | empirical | fixed | derived (with from), params, source?: {kind: research|data|hand|derived, ref}}, derived?: {from: [1..8 dimension keys], fn: {kind: band, of, edges: [ascending], labels: [edges+1]} | {kind: lookup, of, map: {value: result}, default?} | {kind: arith, op: add|sub|mul|div|min|max, args: [keys | numbers | "$reference_year"]}}, refines?: <inherited key>, conditional_on?: [{dimension, when?, tilt: {}}], dynamics?: static | {kind: drift, rate: <per day>} | {kind: decay, half_life_days: >0} | {kind: event, on: name | [names]}, effects?: [{measure, direction: up|down|mixed|none, strength?: 0..1}], privacy?: normal|special_aggregate_only, ui_group?: Identity|Life|Money|Taste & style|Social|Shopping|custom} |
/dimensions/:pack/:keymemberOne dimension at a version (?version=, default latest) and its versions.
/dimensions/:pack/:keyadminRetire a dimension from one of your packs: the pack's next version no longer carries it. Its versions stay readable; refused while another of the pack's dimensions leans on it, or when the pack only inherits it.

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