Schema reference

The schema is the current public contract for the entities Particulars models. Stable documented fields belong here. Internal implementation fields may exist without becoming part of the public contract.

There is not yet a general public API. This page documents the model so users and builders can understand the ontology, inspect exports, and see how future capabilities connect to the same underlying system.

The schema will expand as new product entities become public.

Organization

The privacy and billing boundary for a set of teams, members, connectors, and records.

Org
A workspace. Members join automatically by email domain.
FieldTypeDescription
id · requiredstringStable identifier.
slug · requiredstringURL slug. Globally unique.
name · requiredstringDisplay name.
createdAt · requiredDateCreation timestamp.
brandColorstring?Optional org brand hex (e.g. #BE2D6E).

Member

A person's membership and permission level inside one organization.

Member
A user's relationship to an org. Composite primary key (orgId + userId).
FieldTypeDescription
orgId · requiredstringParent org.
userId · requiredstringUser identity.
email · requiredstringEmail at time of join.
role · required'owner' | 'member'Permission level.
joinedAt · requiredDateWhen the user joined.

Domain

An email domain authorized for automatic organization membership.

Domain
An email domain that auto-joins users to an org.
FieldTypeDescription
orgId · requiredstringParent org.
domain · requiredstringBare domain (e.g. acme.co). Globally unique.

Charter

The human-readable projection of one team or role model.

Charter
A team or role charter. The unit of value.
FieldTypeDescription
id · requiredstringStable identifier.
slug · requiredstringURL slug. Unique per org (or globally for unscoped charters).
orgIdstring?Parent org, if any. Null for public charters.
teamName · requiredstringHuman-readable team name.
teamMission · requiredstringOne sentence — the reason this team exists.
focusAreas · requiredstring[]What the team prioritizes. 3–7 items.
measures · requiredMeasure[]Lagging and leading indicators.
decisionRights · requiredDecisionRight[]Per-decision DICE assignments.
roles · requiredRole[]Each role on the team.
guidelines · requiredGuideline[]Working agreements.
iconSpec · requiredIconSpecDeterministic icon spec.
creatorEmailstring?First editor — empty for unclaimed public charters.
editorEmails · requiredstring[]Allowed editor emails.
lastEditedAt · requiredDateLast save timestamp.

Measure

A signal the team uses to understand whether the work is moving in the intended direction.

Measure
A single metric the team tracks.
FieldTypeDescription
verb · requiredstringDirection: increase, decrease, maintain, etc.
description · requiredstringWhat is being measured.
source · requiredstringWhere the number lives (URL or freeform).

DecisionRight

A recurring area of authority with DICE assignments.

DecisionRight
A single decision area with DICE assignments.
FieldTypeDescription
description · requiredstringThe decision being assigned.
decides · requiredstring[]Roles that Decide.
informed · requiredstring[]Roles that are Informed.
consulted · requiredstring[]Roles that are Consulted.
executes · requiredstring[]Roles that Execute.

Role

A coherent unit of work inside a team, with a focus and one or more possible fillers.

Role
A single role on the team.
FieldTypeDescription
title · requiredstringRole title (e.g. 'Analyst').
focus · requiredstringWhat this role focuses on.
personstring?Named person, if filled.

Guideline

A local operating rule or working agreement.

Guideline
A working agreement.
FieldTypeDescription
title · requiredstringShort label.
textstring?Optional longer text.