{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/sudomock-com/json-schema/sudomock-com-font-response-schema.json",
  "title": "FontResponse",
  "description": "A single font in the catalog: a shared system font, or one of the\ncaller's own uploaded fonts.",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/sudomock-com-openapi.json#/components/schemas/FontResponse",
  "properties": {
    "uuid": {
      "type": "string",
      "description": "Font id"
    },
    "family": {
      "type": "string",
      "description": "Font family name, e.g. 'Open Sans'"
    },
    "subfamily": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Style within the family, e.g. 'Bold Italic'"
    },
    "postscript_name": {
      "type": "string",
      "description": "PostScript name, the stable key used to reference this font when rendering text layers"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Catalog category, e.g. 'SANS_SERIF', 'SERIF', 'DISPLAY'"
    },
    "license": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "License identifier (system fonts)"
    },
    "is_premium": {
      "type": "boolean",
      "description": "Whether this is a premium catalog font",
      "default": false
    },
    "is_system": {
      "type": "boolean",
      "description": "True for the shared system catalog, False for a font you uploaded"
    },
    "preview_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Legacy rendered preview image, when available; new catalog entries no longer include one (use file_url for live previews)"
    },
    "file_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "URL of the web-optimized WOFF2 file for live @font-face preview: a public CDN URL for system fonts, a short-lived link for your own uploads. Null for premium fonts; the original TTF/OTF source is never exposed."
    },
    "created_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "When the font was added"
    }
  },
  "type": "object",
  "required": [
    "uuid",
    "family",
    "postscript_name",
    "is_system"
  ]
}