{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/onlyworlds-com/json-schema/onlyworlds-com-character-schema.json",
  "title": "Character",
  "description": "A character as the API returns it. Single links are an id or null, multi links an array of ids; extension fields appear inline. `?fields=` returns only the named keys, and `?expand=` replaces the named links' ids with ElementStub objects.",
  "x-generated": "2026-11-20",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/onlyworlds-com-openapi.json#/components/schemas/Character",
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "character"
    },
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "name": {
      "type": "string",
      "maxLength": 255,
      "description": "Name of the element."
    },
    "description": {
      "type": "string",
      "description": "Any kind of details about the element."
    },
    "supertype": {
      "type": "string",
      "maxLength": 128,
      "description": "The top level classification of the element within its type."
    },
    "subtype": {
      "type": "string",
      "maxLength": 128,
      "description": "The sub level classification through which the element is further sorted within its type."
    },
    "image_url": {
      "type": "string",
      "maxLength": 1024,
      "description": "URL to an image representing the element."
    },
    "physicality": {
      "type": "string",
      "description": "The character's visible physical features and body attributes."
    },
    "mentality": {
      "type": "string",
      "description": "The character's mindset, emotional tone, and style of thinking."
    },
    "background": {
      "type": "string",
      "description": "History, upbringing, or formative experiences of the character."
    },
    "motivations": {
      "type": "string",
      "description": "Core desires, goals, or values that drive the character's choices and behavior."
    },
    "reputation": {
      "type": "string",
      "description": "Brief summary of the character's current condition, role, or predicament."
    },
    "height": {
      "type": [
        "integer",
        "null"
      ],
      "description": "The character's approximate or exact height, in the world's length unit (World length_unit)."
    },
    "weight": {
      "type": [
        "integer",
        "null"
      ],
      "description": "The character's approximate or exact weight, in the world's mass unit (World mass_unit)."
    },
    "birth_date": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Moment of birth, in the world's time unit (World time_basic_unit)."
    },
    "charisma": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Ability to attract, inspire, and influence others."
    },
    "coercion": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Capacity to dominate, intimidate, or apply force to shape outcomes."
    },
    "competence": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Skill in planning, understanding, and managing complex systems or situations."
    },
    "compassion": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Willingness to empathize with and care for others."
    },
    "creativity": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Ability to generate novel ideas, perspectives, or solutions."
    },
    "courage": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Readiness to face danger, risk, or adversity."
    },
    "level": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Progression rank of the character in a game system."
    },
    "hit_points": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Total health available to the character."
    },
    "STR": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Physical force and carrying capacity."
    },
    "DEX": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Agility, coordination, and reflexes."
    },
    "CON": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Endurance and resistance to strain."
    },
    "INT": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Reasoning, memory, and learning."
    },
    "WIS": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Intuition, awareness, and judgment."
    },
    "CHA": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Persuasiveness and personal magnetism."
    },
    "birthplace": {
      "type": [
        "string",
        "null"
      ],
      "format": "uuid",
      "description": "Location where the character was born. A Location's id."
    },
    "location": {
      "type": [
        "string",
        "null"
      ],
      "format": "uuid",
      "description": "The character's present physical location. A Location's id."
    },
    "species": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "description": "Species the character might belong to. Species ids, as stored (a write keeps each id once)."
    },
    "traits": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "description": "Traits for notable behavioral, physical, or systemic characteristics. Trait ids, as stored (a write keeps each id once)."
    },
    "abilities": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "description": "Abilities the character might perform, control, or invoke. Ability ids, as stored (a write keeps each id once)."
    },
    "languages": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "description": "Languages the character can understand, speak, or use for communication. Language ids, as stored (a write keeps each id once)."
    },
    "objects": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "description": "Key objects owned by or symbolically linked to the character. Object ids, as stored (a write keeps each id once)."
    },
    "institutions": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "description": "Institutions the character is affiliated with. Institution ids, as stored (a write keeps each id once)."
    },
    "family": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "description": "Families the character belongs to by blood or adoption. Family ids, as stored (a write keeps each id once)."
    },
    "friends": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "description": "Characters the character considers close allies or companions. Character ids, as stored (a write keeps each id once)."
    },
    "rivals": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "description": "Characters the character is in active opposition or competition with. Character ids, as stored (a write keeps each id once)."
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time"
    },
    "change_seq": {
      "type": "integer",
      "description": "The world change sequence at this element's last write."
    },
    "created_by": {
      "type": [
        "string",
        "null"
      ],
      "format": "uuid",
      "readOnly": true,
      "description": "The world membership that created this element, or null when the world's owner did. Members only: absent for the public, as `doors` is."
    },
    "changed_by": {
      "type": [
        "string",
        "null"
      ],
      "format": "uuid",
      "readOnly": true,
      "description": "The world membership that last changed this element, or null when the world's owner (or the server) did, or no write has touched it since doors were recorded: null with a non-null `changed_via` other than `server` is the world owner's write (the owner is the account, not a membership); null with `server` is the server's own write; null in both is a row from before writers were recorded. An id whose row on GET /members has `status: removed` is a former member's write: the id outlives the membership (removed, left, or its account deleted), and is never the owner's. Members only: absent for the public, as `doors` is."
    },
    "changed_via": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "seat",
        "mcp",
        "declared",
        "api",
        "v1",
        "sync",
        "server",
        "site",
        null
      ],
      "readOnly": true,
      "description": "The door of the last change: `seat` (an AI seat), `mcp` (the MCP server), `declared` (the request sent an X-OW-Agent header), `api`, `v1`, `sync` (the mobile app's sync), `site` (the owner on onlyworlds.com) or `server` (the server, on its own behalf). The first three are the doors the platform marks as an AI's. Null: no write since doors were recorded. Members only: absent for the public, as `doors` is."
    },
    "changed_client": {
      "type": [
        "string",
        "null"
      ],
      "maxLength": 32,
      "readOnly": true,
      "description": "The name the client gave itself on the last change, in its X-OW-Client header (`atlas`, `lantern`, `sdk`): the client's claim, never proof, and it changes nothing about the door the change came through (that is `changed_via`). Null: no name sent, a value outside the rule, a server write, or a change from before names were recorded. Members only: absent for the public, as `doors` is."
    },
    "doors": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": "string",
        "format": "date-time"
      },
      "maxProperties": 16,
      "readOnly": true,
      "description": "Where this element has been: one key per tool that wrote it, each with the time of that tool's last write (the same string as `updated_at` after that write, so the newest key's time is this body's `updated_at`). The key is the name the client gave in its X-OW-Client header (`atlas`, `lantern`) when it sent one, else the door the write came through (`api`, `seat`, `mcp`, `server` and the other `changed_via` words), never both for one write. At most 16 keys: a new one past that drops the key with the oldest time. Members only: served to the world's owner and every member (co-builders, contributors, guests and AI seats); absent for the public, absent on a known-of stub, and never in the change feed or a world file. Null: no write since the history was recorded. A write carrying it is accepted and the key ignored."
    },
    "known_of": {
      "type": "boolean",
      "const": true,
      "readOnly": true,
      "description": "Present, and true, only on an element this reader knows of but does not see whole: a guest or player reaches it only because its own Character's sheet links to it (one step out). Such a row keeps `id`, `type`, `name`, `description`, `supertype`, `subtype`, `image_url`, `created_at`, `updated_at` and `change_seq`, and its type's public fields (for a character: `physicality`, `height`, `weight`, `species`, `reputation`; a link among them still names only what the reader sees); every other field reads as unset (text \"\", numbers and single links null, multi links [], `created_by`, `changed_by` and `changed_via` null, no `doors`, no extension fields), its files are 404, and search matches only what it keeps. Absent: the element is whole. Any other grant (it names the reader's Character, the reader knows it, it is on the roster, the reader made it) makes it whole; a hidden element is never even a stub, whatever its public fields. Read-only: a write carrying `known_of` is refused (`known_of_not_writable`)."
    },
    "hidden": {
      "type": "boolean",
      "const": true,
      "readOnly": true,
      "description": "Present, and true, only when the world's owner or a co-builder hid this element and this reader still sees it: the owner, a co-builder, a key the owner minted, or the member who made it (to every other reader it does not exist). Absent otherwise, never false. A world file (the site's download) never carries it. Sent back in an update, it is ignored: hide and unhide an existing element through PUT and DELETE /{type}/{id}/hidden. Sent on a create, `hidden: true` creates the element hidden (the write body's `hidden`)."
    }
  },
  "patternProperties": {
    "^(atlas_|shadow_|x_)": {
      "description": "Extension field, stored opaquely and returned verbatim (any JSON value; at most 65536 bytes of extensions per element, counted as compact UTF-8 JSON). For the public reader, a review mark (`x_review_checked`) that is an object holding `by` is served with `by` null and its other keys as stored."
    }
  },
  "additionalProperties": false,
  "required": [
    "type",
    "id",
    "name",
    "description",
    "supertype",
    "subtype",
    "image_url",
    "physicality",
    "mentality",
    "background",
    "motivations",
    "reputation",
    "height",
    "weight",
    "birth_date",
    "charisma",
    "coercion",
    "competence",
    "compassion",
    "creativity",
    "courage",
    "level",
    "hit_points",
    "STR",
    "DEX",
    "CON",
    "INT",
    "WIS",
    "CHA",
    "birthplace",
    "location",
    "species",
    "traits",
    "abilities",
    "languages",
    "objects",
    "institutions",
    "family",
    "friends",
    "rivals",
    "created_at",
    "updated_at",
    "change_seq"
  ]
}