FunkoManifest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/immersivecommons-com/json-schema/immersivecommons-com-funko-manifest-schema.json",
  "title": "FunkoManifest",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/immersivecommons-com-openapi.json#/components/schemas/FunkoManifest",
  "type": "object",
  "required": [
    "handle",
    "displayName",
    "tier",
    "parts",
    "clips",
    "props",
    "activeClip",
    "stats",
    "profileUrl",
    "generatedAt"
  ],
  "properties": {
    "handle": {
      "type": "string",
      "description": "URL-safe lowercase handle."
    },
    "displayName": {
      "type": "string"
    },
    "tier": {
      "type": "string",
      "description": "The member's ring: public | ft-member | ai-floor | ic-member | operator."
    },
    "parts": {
      "type": "object",
      "required": [
        "body",
        "library",
        "head"
      ],
      "properties": {
        "body": {
          "type": "string",
          "description": "Absolute https URL. Shared 62k-tri rigged body, identical for every member."
        },
        "library": {
          "type": "string",
          "description": "Absolute https URL. Shared skeleton-only clip library."
        },
        "head": {
          "type": "string",
          "description": "Absolute https URL. Per-person head, a rigid child of the Head bone."
        }
      },
      "description": "Compose these client-side. Do NOT expect one baked file."
    },
    "bakedGlbUrl": {
      "type": "string",
      "description": "OPTIONAL FOREVER. Present only if a single-file bake exists. Never require it."
    },
    "thumbUrl": {
      "type": "string"
    },
    "clips": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Animation names inside library.glb that this member has actually UNLOCKED. Never the full set — the unlock set is the membership signal."
    },
    "props": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Socketed props, re-filtered against live unlocks on every read."
    },
    "activeClip": {
      "type": "string",
      "description": "The clip to play by default. Always one of `clips`, or empty when none are unlocked."
    },
    "stats": {
      "type": "array",
      "description": "The measurables behind the unlocks.",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "value": {
            "type": [
              "integer",
              "null"
            ],
            "description": "null means the source could NOT be read. It does not mean zero — do not render it as 0."
          },
          "unit": {
            "type": "string"
          }
        }
      }
    },
    "profileUrl": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string",
      "description": "ISO-8601 of this response, not of the underlying data."
    }
  },
  "additionalProperties": true
}