Profile

A persona, not a folder: "Steven - Work", "Steven - Personal".

Creating one requires no login. [Profile::account] remains None until an explicit compare-and-set binds a hosted Koru Identity. A ProfileId remains distinct from account identity and content identity never changes.

A legacy Holder row can still be decoded for migration compatibility, but current code creates personas only.

Type object

Shape

Field	Type	Description
idrequired	ProfileId
namerequired	string
purpose	string or null	Free text the person chose - "work", "school". Not an enum: it is theirs.
avatar	string or null	A token, never a colour value and never a path. `color:<name>` today; `blob:<hash>` when a person can upload a picture. The prefix is what makes that addition free - a reader splits on the first colon and branches - where a bare `purple` would have needed a migration. The store never interprets it. A client maps `color:purple` back to whatever purple is in the theme it is drawing, which is what keeps one theme's rendering of a colour out of the person's profile.
icon	string or null	Emoji and named tile colour used by profile switchers. Kept separate from `avatar` so a profile can have both an icon and a colour.
color	string or null
account	string or null	Exact `koru:<canonical-v4-identity-uuid>` after acknowledged attachment; `None` while local-only. Never an email or provider subject.
localerequired	Locale	BCP 47. Belongs to the person, never to their content.
created_atrequired	Timestamp	Epoch milliseconds, UTC. Signed, so instants before 1970 are representable.
kind	ProfileKind	Persona or legacy compatibility holder. See [`ProfileKind`]. `#[serde(default)]` keeps profiles written before the field readable. Current creation always writes `Normal`. Default `"normal"`

Example

{
  "id": "00000000-0000-4000-8000-000000000000",
  "name": "string",
  "purpose": "string",
  "avatar": "string",
  "icon": "string",
  "color": "string",
  "account": "string",
  "locale": {},
  "created_at": 0,
  "kind": "normal"
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Used by

Generated from contract version 1. Last updated November 12, 2026.