Skip to main content
Glama

Briefdesign speichern

letter_design_save

Speichert ein wiederverwendbares Briefpapier (Briefdesign) mit schemaVersion 1 oder 2 im Partnerprofil und gibt designId sowie den Hash der gespeicherten Quelldaten zurück. Dasselbe Briefpapier trägt danach jede Post: Kündigung, Rechnung, Mahnung, Angebot, Vertrag und Behördenpost. Der technische Tool-Name ist letter_design_save. Das Design wird vor dem Speichern vollständig validiert und gegen die Zustellzonen geprüft. EN: Saves a reusable schemaVersion 1 or 2 letterhead (letter design) in the partner profile and returns its designId and stored-source hash. The same stationery then carries every kind of mail: cancellation, invoice, payment reminder, quote, contract and letters to public authorities. The technical tool name is letter_design_save. The design is fully validated and checked against postal clear zones before it is stored.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "name": "<name>",
      "design": "<design>"
    },
    "name": "letter_design_save"
  }
}

Input Schema

NameRequiredDescriptionDefault
nameYesEindeutiger Name des Briefdesigns. EN: Unique name of the letter design.
designYes
designIdNo
reasoningNo
brandingOwnershipConfirmedNoBei einer Neuanlage oder geänderten Branding-Asset-Referenz zwingend true. Unveränderte Folgespeicherungen brauchen keine erneute Bestätigung. EN: Required as true when creating or changing a branding asset reference. Unchanged iterative saves need no renewed confirmation.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / design / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "barcode": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "enabled": {
      -            "default": false,
      -            "type": "boolean"
      -          },
      -          "marginRightYMm": {
      -            "default": 100,
      -            "maximum": 270,
      -            "minimum": 92,
      -            "type": "number"
      -          },
      -          "payloadTemplate": {
      -            "maxLength": 512,
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "placement": {
      -            "default": "infoblock",
      -            "enum": [
      -              "infoblock",
      -              "footer-right",
      -              "margin-right"
      -            ],
      -            "type": "string"
      -          },
      -          "sizeMm": {
      -            "default": 22,
      -            "maximum": 40,
      -            "minimum": 12,
      -            "type": "number"
      -          },
      -          "type": {
      -            "default": "qr",
      -            "enum": [
      -              "qr",
      -              "code128"
      -            ],
      -            "type": "string"
      -          },
      -          "widthMm": {
      -            "default": 50,
      -            "maximum": 90,
      -            "minimum": 20,
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "chrome": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "dateLine": {
      -            "type": "boolean"
      -          },
      -          "recipientBlock": {
      -            "type": "boolean"
      -          },
      -          "subjectLine": {
      -            "type": "boolean"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "continuation": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "enabled": {
      -            "default": false,
      -            "type": "boolean"
      -          },
      -          "headerLine": {
      -            "default": true,
      -            "type": "boolean"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "documentMode": {
      -        "enum": [
      -          "letter",
      -          "form"
      -        ],
      -        "type": "string"
      -      },
      -      "falzmarken": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "enabled": {
      -            "default": false,
      -            "type": "boolean"
      -          },
      -          "falz": {
      -            "default": true,
      -            "type": "boolean"
      -          },
      -          "lochmarke": {
      -            "default": true,
      -            "type": "boolean"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "footer": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "columns": {
      -            "items": {
      -              "items": {
      -                "maxLength": 120,
      -                "type": "string"
      -              },
      -              "maxItems": 8,
      -              "minItems": 1,
      -              "type": "array"
      -            },
      -            "maxItems": 4,
      -            "minItems": 1,
      -            "type": "array"
      -          },
      -          "enabled": {
      -            "default": false,
      -            "type": "boolean"
      -          },
      -          "fontSizePt": {
      -            "default": 7,
      -            "maximum": 9,
      -            "minimum": 6,
      -            "type": "number"
      -          },
      -          "scope": {
      -            "default": "first-page",
      -            "enum": [
      -              "first-page",
      -              "all-letter-pages"
      -            ],
      -            "type": "string"
      -          },
      -          "topMm": {
      -            "default": 272,
      -            "maximum": 285,
      -            "minimum": 250,
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "columns"
      -        ],
      -        "type": "object"
      -      },
      -      "header": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "heightMm": {
      -            "maximum": 120,
      -            "minimum": 5,
      -            "type": "number"
      -          },
      -          "letterheadId": {
      -            "anyOf": [
      -              {
      -                "format": "uuid",
      -                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "offsetXMm": {
      -            "default": 0,
      -            "maximum": 170,
      -            "minimum": 0,
      -            "type": "number"
      -          },
      -          "offsetYMm": {
      -            "default": 8,
      -            "maximum": 40,
      -            "minimum": 0,
      -            "type": "number"
      -          },
      -          "placement": {
      -            "default": "top",
      -            "enum": [
      -              "top",
      -              "logo-right",
      -              "full"
      -            ],
      -            "type": "string"
      -          },
      -          "replaceSenderBlock": {
      -            "default": false,
      -            "type": "boolean"
      -          },
      -          "widthMm": {
      -            "default": 165,
      -            "maximum": 210,
      -            "minimum": 10,
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "infoblock": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "enabled": {
      -            "default": false,
      -            "type": "boolean"
      -          },
      -          "fontSizePt": {
      -            "default": 8,
      -            "maximum": 10,
      -            "minimum": 7,
      -            "type": "number"
      -          },
      -          "labelWidthMm": {
      -            "default": 28,
      -            "maximum": 40,
      -            "minimum": 15,
      -            "type": "number"
      -          },
      -          "rows": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "key": {
      -                  "pattern": "^[a-z][a-z0-9_]{0,30}$",
      -                  "type": "string"
      -                },
      -                "label": {
      -                  "maxLength": 120,
      -                  "minLength": 1,
      -                  "type": "string"
      -                },
      -                "staticValue": {
      -                  "anyOf": [
      -                    {
      -                      "maxLength": 200,
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                }
      -              },
      -              "required": [
      -                "key",
      -                "label"
      -              ],
      -              "type": "object"
      -            },
      -            "maxItems": 12,
      -            "minItems": 1,
      -            "type": "array"
      -          },
      -          "topMm": {
      -            "default": 45,
      -            "maximum": 90,
      -            "minimum": 32,
      -            "type": "number"
      -          },
      -          "valueWidthMm": {
      -            "default": 37,
      -            "maximum": 55,
      -            "minimum": 20,
      -            "type": "number"
      -          },
      -          "xMm": {
      -            "default": 125,
      -            "maximum": 170,
      -            "minimum": 118,
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "rows"
      -        ],
      -        "type": "object"
      -      },
      -      "marginText": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "fontSizePt": {
      -            "default": 6,
      -            "maximum": 9,
      -            "minimum": 5,
      -            "type": "number"
      -          },
      -          "rotationDeg": {
      -            "anyOf": [
      -              {
      -                "const": 90,
      -                "type": "number"
      -              },
      -              {
      -                "const": 270,
      -                "type": "number"
      -              }
      -            ],
      -            "default": 90
      -          },
      -          "side": {
      -            "default": "left",
      -            "enum": [
      -              "left",
      -              "right"
      -            ],
      -            "type": "string"
      -          },
      -          "text": {
      -            "maxLength": 160,
      -            "minLength": 1,
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "text"
      -        ],
      -        "type": "object"
      -      },
      -      "schemaVersion": {
      -        "const": 1,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "schemaVersion"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "description": "Native v2 authoring schema. Standard JSON Schema covers shape, defaults, native enums, asset and box dependencies. Runtime Zod validation remains authoritative for template grammar, duplicate element ids, and arithmetic A4 placement.",
      -    "properties": {
      -      "body": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "font": {
      -            "anyOf": [
      -              {
      -                "enum": [
      -                  "serif",
      -                  "humanist-sans",
      -                  "grotesk",
      -                  "mono"
      -                ],
      -                "type": "string"
      -              },
      -              {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "token": {
      -                    "const": "brand.font",
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "token"
      -                ],
      -                "type": "object"
      -              }
      -            ]
      -          },
      -          "lineHeightPt": {
      -            "maximum": 30,
      -            "minimum": 7,
      -            "type": "number"
      -          },
      -          "senderBlockStyle": {
      -            "default": "inherit",
      -            "enum": [
      -              "inherit",
      -              "compact",
      -              "hidden"
      -            ],
      -            "type": "string"
      -          },
      -          "sizePt": {
      -            "maximum": 18,
      -            "minimum": 6,
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "font",
      -          "sizePt",
      -          "lineHeightPt"
      -        ],
      -        "type": "object"
      -      },
      -      "furniture": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "barcode": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "enabled": {
      -                "default": false,
      -                "type": "boolean"
      -              },
      -              "marginRightYMm": {
      -                "default": 100,
      -                "maximum": 270,
      -                "minimum": 92,
      -                "type": "number"
      -              },
      -              "payloadTemplate": {
      -                "maxLength": 512,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "placement": {
      -                "default": "infoblock",
      -                "enum": [
      -                  "infoblock",
      -                  "footer-right",
      -                  "margin-right"
      -                ],
      -                "type": "string"
      -              },
      -              "sizeMm": {
      -                "default": 22,
      -                "maximum": 40,
      -                "minimum": 12,
      -                "type": "number"
      -              },
      -              "type": {
      -                "default": "qr",
      -                "enum": [
      -                  "qr",
      -                  "code128"
      -                ],
      -                "type": "string"
      -              },
      -              "widthMm": {
      -                "default": 50,
      -                "maximum": 90,
      -                "minimum": 20,
      -                "type": "number"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "chrome": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "dateLine": {
      -                "type": "boolean"
      -              },
      -              "recipientBlock": {
      -                "type": "boolean"
      -              },
      -              "subjectLine": {
      -                "type": "boolean"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "continuation": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "enabled": {
      -                "default": false,
      -                "type": "boolean"
      -              },
      -              "headerLine": {
      -                "default": true,
      -                "type": "boolean"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "documentMode": {
      -            "enum": [
      -              "letter",
      -              "form"
      -            ],
      -            "type": "string"
      -          },
      -          "falzmarken": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "enabled": {
      -                "default": false,
      -                "type": "boolean"
      -              },
      -              "falz": {
      -                "default": true,
      -                "type": "boolean"
      -              },
      -              "lochmarke": {
      -                "default": true,
      -                "type": "boolean"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "infoblock": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "enabled": {
      -                "default": false,
      -                "type": "boolean"
      -              },
      -              "fontSizePt": {
      -                "default": 8,
      -                "maximum": 10,
      -                "minimum": 7,
      -                "type": "number"
      -              },
      -              "labelWidthMm": {
      -                "default": 28,
      -                "maximum": 40,
      -                "minimum": 15,
      -                "type": "number"
      -              },
      -              "rows": {
      -                "items": {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "key": {
      -                      "pattern": "^[a-z][a-z0-9_]{0,30}$",
      -                      "type": "string"
      -                    },
      -                    "label": {
      -                      "maxLength": 120,
      -                      "minLength": 1,
      -                      "type": "string"
      -                    },
      -                    "staticValue": {
      -                      "anyOf": [
      -                        {
      -                          "maxLength": 200,
      -                          "type": "string"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ]
      -                    }
      -                  },
      -                  "required": [
      -                    "key",
      -                    "label"
      -                  ],
      -                  "type": "object"
      -                },
      -                "maxItems": 12,
      -                "minItems": 1,
      -                "type": "array"
      -              },
      -              "topMm": {
      -                "default": 45,
      -                "maximum": 90,
      -                "minimum": 32,
      -                "type": "number"
      -              },
      -              "valueWidthMm": {
      -                "default": 37,
      -                "maximum": 55,
      -                "minimum": 20,
      -                "type": "number"
      -              },
      -              "xMm": {
      -                "default": 125,
      -                "maximum": 170,
      -                "minimum": 118,
      -                "type": "number"
      -              }
      -            },
      -            "required": [
      -              "rows"
      -            ],
      -            "type": "object"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "schemaVersion": {
      -        "const": 2,
      -        "type": "number"
      -      },
      -      "zones": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "continuationHeader": {
      -            "$ref": "#/$defs/letterDesignV2Zone"
      -          },
      -          "footer": {
      -            "$ref": "#/$defs/letterDesignV2Zone"
      -          },
      -          "header": {
      -            "$ref": "#/$defs/letterDesignV2Zone"
      -          },
      -          "sidebar": {
      -            "$ref": "#/$defs/letterDesignV2Zone"
      -          },
      -          "watermark": {
      -            "$ref": "#/$defs/letterDesignV2Zone"
      -          }
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "schemaVersion",
      -      "zones",
      -      "body"
      -    ],
      -    "semanticValidation": {
      -      "authority": "designV2Schema (Zod runtime)",
      -      "runtimeOnly": [
      -        "template placeholder grammar",
      -        "element ids unique across zones",
      -        "reservedBox xMm + widthMm <= 210 and yMm + heightMm <= 297",
      -        "anchored element rectangle remains within 210 x 297 mm A4",
      -        "v1 compatibility payloads are internal migration output and are rejected by native authoring"
      -      ]
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "barcode": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "enabled": {
      +            "default": false,
      +            "type": "boolean"
      +          },
      +          "marginRightYMm": {
      +            "default": 100,
      +            "maximum": 270,
      +            "minimum": 92,
      +            "type": "number"
      +          },
      +          "payloadTemplate": {
      +            "maxLength": 512,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "placement": {
      +            "default": "infoblock",
      +            "enum": [
      +              "infoblock",
      +              "footer-right",
      +              "margin-right"
      +            ],
      +            "type": "string"
      +          },
      +          "sizeMm": {
      +            "default": 22,
      +            "maximum": 40,
      +            "minimum": 12,
      +            "type": "number"
      +          },
      +          "type": {
      +            "default": "qr",
      +            "enum": [
      +              "qr",
      +              "code128"
      +            ],
      +            "type": "string"
      +          },
      +          "widthMm": {
      +            "default": 50,
      +            "maximum": 90,
      +            "minimum": 20,
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "chrome": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "dateLine": {
      +            "type": "boolean"
      +          },
      +          "recipientBlock": {
      +            "type": "boolean"
      +          },
      +          "subjectLine": {
      +            "type": "boolean"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "continuation": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "enabled": {
      +            "default": false,
      +            "type": "boolean"
      +          },
      +          "headerLine": {
      +            "default": true,
      +            "type": "boolean"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "documentMode": {
      +        "enum": [
      +          "letter",
      +          "form"
      +        ],
      +        "type": "string"
      +      },
      +      "falzmarken": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "enabled": {
      +            "default": false,
      +            "type": "boolean"
      +          },
      +          "falz": {
      +            "default": true,
      +            "type": "boolean"
      +          },
      +          "lochmarke": {
      +            "default": true,
      +            "type": "boolean"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "footer": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "columns": {
      +            "items": {
      +              "items": {
      +                "maxLength": 120,
      +                "type": "string"
      +              },
      +              "maxItems": 8,
      +              "minItems": 1,
      +              "type": "array"
      +            },
      +            "maxItems": 4,
      +            "minItems": 1,
      +            "type": "array"
      +          },
      +          "enabled": {
      +            "default": false,
      +            "type": "boolean"
      +          },
      +          "fontSizePt": {
      +            "default": 7,
      +            "maximum": 9,
      +            "minimum": 6,
      +            "type": "number"
      +          },
      +          "scope": {
      +            "default": "first-page",
      +            "enum": [
      +              "first-page",
      +              "all-letter-pages"
      +            ],
      +            "type": "string"
      +          },
      +          "topMm": {
      +            "default": 272,
      +            "maximum": 285,
      +            "minimum": 250,
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "columns"
      +        ],
      +        "type": "object"
      +      },
      +      "header": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "heightMm": {
      +            "maximum": 120,
      +            "minimum": 5,
      +            "type": "number"
      +          },
      +          "letterheadId": {
      +            "anyOf": [
      +              {
      +                "format": "uuid",
      +                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "offsetXMm": {
      +            "default": 0,
      +            "maximum": 170,
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "offsetYMm": {
      +            "default": 8,
      +            "maximum": 40,
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "placement": {
      +            "default": "top",
      +            "enum": [
      +              "top",
      +              "logo-right",
      +              "full"
      +            ],
      +            "type": "string"
      +          },
      +          "replaceSenderBlock": {
      +            "default": false,
      +            "type": "boolean"
      +          },
      +          "widthMm": {
      +            "default": 165,
      +            "maximum": 210,
      +            "minimum": 10,
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "infoblock": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "enabled": {
      +            "default": false,
      +            "type": "boolean"
      +          },
      +          "fontSizePt": {
      +            "default": 8,
      +            "maximum": 10,
      +            "minimum": 7,
      +            "type": "number"
      +          },
      +          "labelWidthMm": {
      +            "default": 28,
      +            "maximum": 40,
      +            "minimum": 15,
      +            "type": "number"
      +          },
      +          "rows": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "key": {
      +                  "pattern": "^[a-z][a-z0-9_]{0,30}$",
      +                  "type": "string"
      +                },
      +                "label": {
      +                  "maxLength": 120,
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "staticValue": {
      +                  "anyOf": [
      +                    {
      +                      "maxLength": 200,
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "key",
      +                "label"
      +              ],
      +              "type": "object"
      +            },
      +            "maxItems": 12,
      +            "minItems": 1,
      +            "type": "array"
      +          },
      +          "topMm": {
      +            "default": 45,
      +            "maximum": 90,
      +            "minimum": 32,
      +            "type": "number"
      +          },
      +          "valueWidthMm": {
      +            "default": 37,
      +            "maximum": 55,
      +            "minimum": 20,
      +            "type": "number"
      +          },
      +          "xMm": {
      +            "default": 125,
      +            "maximum": 170,
      +            "minimum": 118,
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "rows"
      +        ],
      +        "type": "object"
      +      },
      +      "marginText": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "fontSizePt": {
      +            "default": 6,
      +            "maximum": 9,
      +            "minimum": 5,
      +            "type": "number"
      +          },
      +          "rotationDeg": {
      +            "anyOf": [
      +              {
      +                "const": 90,
      +                "type": "number"
      +              },
      +              {
      +                "const": 270,
      +                "type": "number"
      +              }
      +            ],
      +            "default": 90
      +          },
      +          "side": {
      +            "default": "left",
      +            "enum": [
      +              "left",
      +              "right"
      +            ],
      +            "type": "string"
      +          },
      +          "text": {
      +            "maxLength": 160,
      +            "minLength": 1,
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "text"
      +        ],
      +        "type": "object"
      +      },
      +      "schemaVersion": {
      +        "const": 1,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "schemaVersion"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "description": "Natives v2-Gestaltungsschema. Das JSON Schema deckt Form, Standardwerte, Enums sowie Asset- und Box-Abhängigkeiten ab; Vorlagengrammatik, doppelte Element-IDs und die A4-Platzierung prüft die Laufzeitvalidierung (Zod). EN: Native v2 authoring schema. Standard JSON Schema covers shape, defaults, native enums, asset and box dependencies. Runtime Zod validation remains authoritative for template grammar, duplicate element ids, and arithmetic A4 placement.",
      +    "properties": {
      +      "body": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "font": {
      +            "anyOf": [
      +              {
      +                "enum": [
      +                  "serif",
      +                  "humanist-sans",
      +                  "grotesk",
      +                  "mono"
      +                ],
      +                "type": "string"
      +              },
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "token": {
      +                    "const": "brand.font",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "token"
      +                ],
      +                "type": "object"
      +              }
      +            ]
      +          },
      +          "lineHeightPt": {
      +            "maximum": 30,
      +            "minimum": 7,
      +            "type": "number"
      +          },
      +          "senderBlockStyle": {
      +            "default": "inherit",
      +            "enum": [
      +              "inherit",
      +              "compact",
      +              "hidden"
      +            ],
      +            "type": "string"
      +          },
      +          "sizePt": {
      +            "maximum": 18,
      +            "minimum": 6,
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "font",
      +          "sizePt",
      +          "lineHeightPt"
      +        ],
      +        "type": "object"
      +      },
      +      "furniture": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "barcode": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "enabled": {
      +                "default": false,
      +                "type": "boolean"
      +              },
      +              "marginRightYMm": {
      +                "default": 100,
      +                "maximum": 270,
      +                "minimum": 92,
      +                "type": "number"
      +              },
      +              "payloadTemplate": {
      +                "maxLength": 512,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "placement": {
      +                "default": "infoblock",
      +                "enum": [
      +                  "infoblock",
      +                  "footer-right",
      +                  "margin-right"
      +                ],
      +                "type": "string"
      +              },
      +              "sizeMm": {
      +                "default": 22,
      +                "maximum": 40,
      +                "minimum": 12,
      +                "type": "number"
      +              },
      +              "type": {
      +                "default": "qr",
      +                "enum": [
      +                  "qr",
      +                  "code128"
      +                ],
      +                "type": "string"
      +              },
      +              "widthMm": {
      +                "default": 50,
      +                "maximum": 90,
      +                "minimum": 20,
      +                "type": "number"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "chrome": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "dateLine": {
      +                "type": "boolean"
      +              },
      +              "recipientBlock": {
      +                "type": "boolean"
      +              },
      +              "subjectLine": {
      +                "type": "boolean"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "continuation": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "enabled": {
      +                "default": false,
      +                "type": "boolean"
      +              },
      +              "headerLine": {
      +                "default": true,
      +                "type": "boolean"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "documentMode": {
      +            "enum": [
      +              "letter",
      +              "form"
      +            ],
      +            "type": "string"
      +          },
      +          "falzmarken": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "enabled": {
      +                "default": false,
      +                "type": "boolean"
      +              },
      +              "falz": {
      +                "default": true,
      +                "type": "boolean"
      +              },
      +              "lochmarke": {
      +                "default": true,
      +                "type": "boolean"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "infoblock": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "enabled": {
      +                "default": false,
      +                "type": "boolean"
      +              },
      +              "fontSizePt": {
      +                "default": 8,
      +                "maximum": 10,
      +                "minimum": 7,
      +                "type": "number"
      +              },
      +              "labelWidthMm": {
      +                "default": 28,
      +                "maximum": 40,
      +                "minimum": 15,
      +                "type": "number"
      +              },
      +              "rows": {
      +                "items": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "key": {
      +                      "pattern": "^[a-z][a-z0-9_]{0,30}$",
      +                      "type": "string"
      +                    },
      +                    "label": {
      +                      "maxLength": 120,
      +                      "minLength": 1,
      +                      "type": "string"
      +                    },
      +                    "staticValue": {
      +                      "anyOf": [
      +                        {
      +                          "maxLength": 200,
      +                          "type": "string"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    }
      +                  },
      +                  "required": [
      +                    "key",
      +                    "label"
      +                  ],
      +                  "type": "object"
      +                },
      +                "maxItems": 12,
      +                "minItems": 1,
      +                "type": "array"
      +              },
      +              "topMm": {
      +                "default": 45,
      +                "maximum": 90,
      +                "minimum": 32,
      +                "type": "number"
      +              },
      +              "valueWidthMm": {
      +                "default": 37,
      +                "maximum": 55,
      +                "minimum": 20,
      +                "type": "number"
      +              },
      +              "xMm": {
      +                "default": 125,
      +                "maximum": 170,
      +                "minimum": 118,
      +                "type": "number"
      +              }
      +            },
      +            "required": [
      +              "rows"
      +            ],
      +            "type": "object"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "schemaVersion": {
      +        "const": 2,
      +        "type": "number"
      +      },
      +      "zones": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "continuationHeader": {
      +            "$ref": "#/$defs/letterDesignV2Zone"
      +          },
      +          "footer": {
      +            "$ref": "#/$defs/letterDesignV2Zone"
      +          },
      +          "header": {
      +            "$ref": "#/$defs/letterDesignV2Zone"
      +          },
      +          "sidebar": {
      +            "$ref": "#/$defs/letterDesignV2Zone"
      +          },
      +          "watermark": {
      +            "$ref": "#/$defs/letterDesignV2Zone"
      +          }
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "schemaVersion",
      +      "zones",
      +      "body"
      +    ],
      +    "semanticValidation": {
      +      "authority": "designV2Schema (Zod runtime)",
      +      "runtimeOnly": [
      +        "template placeholder grammar",
      +        "element ids unique across zones",
      +        "reservedBox xMm + widthMm <= 210 and yMm + heightMm <= 297",
      +        "anchored element rectangle remains within 210 x 297 mm A4",
      +        "v1 compatibility payloads are internal migration output and are rejected by native authoring"
      +      ]
      +    },
      +    "type": "object"
      +  }
      +]
  2. Changed1 schema field changed
    • changedInput schema / properties / design / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "barcode": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "enabled": {
      -            "default": false,
      -            "type": "boolean"
      -          },
      -          "marginRightYMm": {
      -            "default": 100,
      -            "maximum": 270,
      -            "minimum": 92,
      -            "type": "number"
      -          },
      -          "payloadTemplate": {
      -            "maxLength": 512,
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "placement": {
      -            "default": "infoblock",
      -            "enum": [
      -              "infoblock",
      -              "footer-right",
      -              "margin-right"
      -            ],
      -            "type": "string"
      -          },
      -          "sizeMm": {
      -            "default": 22,
      -            "maximum": 40,
      -            "minimum": 12,
      -            "type": "number"
      -          },
      -          "type": {
      -            "default": "qr",
      -            "enum": [
      -              "qr",
      -              "code128"
      -            ],
      -            "type": "string"
      -          },
      -          "widthMm": {
      -            "default": 50,
      -            "maximum": 90,
      -            "minimum": 20,
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "chrome": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "dateLine": {
      -            "type": "boolean"
      -          },
      -          "recipientBlock": {
      -            "type": "boolean"
      -          },
      -          "subjectLine": {
      -            "type": "boolean"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "continuation": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "enabled": {
      -            "default": false,
      -            "type": "boolean"
      -          },
      -          "headerLine": {
      -            "default": true,
      -            "type": "boolean"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "documentMode": {
      -        "enum": [
      -          "letter",
      -          "form"
      -        ],
      -        "type": "string"
      -      },
      -      "falzmarken": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "enabled": {
      -            "default": false,
      -            "type": "boolean"
      -          },
      -          "falz": {
      -            "default": true,
      -            "type": "boolean"
      -          },
      -          "lochmarke": {
      -            "default": true,
      -            "type": "boolean"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "footer": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "columns": {
      -            "items": {
      -              "items": {
      -                "maxLength": 120,
      -                "type": "string"
      -              },
      -              "maxItems": 8,
      -              "minItems": 1,
      -              "type": "array"
      -            },
      -            "maxItems": 4,
      -            "minItems": 1,
      -            "type": "array"
      -          },
      -          "enabled": {
      -            "default": false,
      -            "type": "boolean"
      -          },
      -          "fontSizePt": {
      -            "default": 7,
      -            "maximum": 9,
      -            "minimum": 6,
      -            "type": "number"
      -          },
      -          "scope": {
      -            "default": "first-page",
      -            "enum": [
      -              "first-page",
      -              "all-letter-pages"
      -            ],
      -            "type": "string"
      -          },
      -          "topMm": {
      -            "default": 272,
      -            "maximum": 285,
      -            "minimum": 250,
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "columns"
      -        ],
      -        "type": "object"
      -      },
      -      "header": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "heightMm": {
      -            "maximum": 120,
      -            "minimum": 5,
      -            "type": "number"
      -          },
      -          "letterheadId": {
      -            "anyOf": [
      -              {
      -                "format": "uuid",
      -                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "offsetXMm": {
      -            "default": 0,
      -            "maximum": 170,
      -            "minimum": 0,
      -            "type": "number"
      -          },
      -          "offsetYMm": {
      -            "default": 8,
      -            "maximum": 40,
      -            "minimum": 0,
      -            "type": "number"
      -          },
      -          "placement": {
      -            "default": "top",
      -            "enum": [
      -              "top",
      -              "logo-right",
      -              "full"
      -            ],
      -            "type": "string"
      -          },
      -          "replaceSenderBlock": {
      -            "default": false,
      -            "type": "boolean"
      -          },
      -          "widthMm": {
      -            "default": 165,
      -            "maximum": 210,
      -            "minimum": 10,
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "infoblock": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "enabled": {
      -            "default": false,
      -            "type": "boolean"
      -          },
      -          "fontSizePt": {
      -            "default": 8,
      -            "maximum": 10,
      -            "minimum": 7,
      -            "type": "number"
      -          },
      -          "labelWidthMm": {
      -            "default": 28,
      -            "maximum": 40,
      -            "minimum": 15,
      -            "type": "number"
      -          },
      -          "rows": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "key": {
      -                  "pattern": "^[a-z][a-z0-9_]{0,30}$",
      -                  "type": "string"
      -                },
      -                "label": {
      -                  "maxLength": 120,
      -                  "minLength": 1,
      -                  "type": "string"
      -                },
      -                "staticValue": {
      -                  "anyOf": [
      -                    {
      -                      "maxLength": 200,
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                }
      -              },
      -              "required": [
      -                "key",
      -                "label"
      -              ],
      -              "type": "object"
      -            },
      -            "maxItems": 12,
      -            "minItems": 1,
      -            "type": "array"
      -          },
      -          "topMm": {
      -            "default": 45,
      -            "maximum": 90,
      -            "minimum": 32,
      -            "type": "number"
      -          },
      -          "valueWidthMm": {
      -            "default": 37,
      -            "maximum": 55,
      -            "minimum": 20,
      -            "type": "number"
      -          },
      -          "xMm": {
      -            "default": 125,
      -            "maximum": 170,
      -            "minimum": 118,
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "rows"
      -        ],
      -        "type": "object"
      -      },
      -      "marginText": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "fontSizePt": {
      -            "default": 6,
      -            "maximum": 9,
      -            "minimum": 5,
      -            "type": "number"
      -          },
      -          "rotationDeg": {
      -            "anyOf": [
      -              {
      -                "const": 90,
      -                "type": "number"
      -              },
      -              {
      -                "const": 270,
      -                "type": "number"
      -              }
      -            ],
      -            "default": 90
      -          },
      -          "side": {
      -            "default": "left",
      -            "enum": [
      -              "left",
      -              "right"
      -            ],
      -            "type": "string"
      -          },
      -          "text": {
      -            "maxLength": 160,
      -            "minLength": 1,
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "text"
      -        ],
      -        "type": "object"
      -      },
      -      "schemaVersion": {
      -        "const": 1,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "schemaVersion"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "description": "Native v2 authoring schema. Standard JSON Schema covers shape, defaults, native enums, asset and box dependencies. Runtime Zod validation remains authoritative for template grammar, duplicate element ids, and arithmetic A4 placement.",
      -    "properties": {
      -      "body": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "font": {
      -            "anyOf": [
      -              {
      -                "enum": [
      -                  "serif",
      -                  "humanist-sans",
      -                  "grotesk",
      -                  "mono"
      -                ],
      -                "type": "string"
      -              },
      -              {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "token": {
      -                    "const": "brand.font",
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "token"
      -                ],
      -                "type": "object"
      -              }
      -            ]
      -          },
      -          "lineHeightPt": {
      -            "maximum": 30,
      -            "minimum": 7,
      -            "type": "number"
      -          },
      -          "senderBlockStyle": {
      -            "default": "inherit",
      -            "enum": [
      -              "inherit",
      -              "compact",
      -              "hidden"
      -            ],
      -            "type": "string"
      -          },
      -          "sizePt": {
      -            "maximum": 18,
      -            "minimum": 6,
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "font",
      -          "sizePt",
      -          "lineHeightPt"
      -        ],
      -        "type": "object"
      -      },
      -      "furniture": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "barcode": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "enabled": {
      -                "default": false,
      -                "type": "boolean"
      -              },
      -              "marginRightYMm": {
      -                "default": 100,
      -                "maximum": 270,
      -                "minimum": 92,
      -                "type": "number"
      -              },
      -              "payloadTemplate": {
      -                "maxLength": 512,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "placement": {
      -                "default": "infoblock",
      -                "enum": [
      -                  "infoblock",
      -                  "footer-right",
      -                  "margin-right"
      -                ],
      -                "type": "string"
      -              },
      -              "sizeMm": {
      -                "default": 22,
      -                "maximum": 40,
      -                "minimum": 12,
      -                "type": "number"
      -              },
      -              "type": {
      -                "default": "qr",
      -                "enum": [
      -                  "qr",
      -                  "code128"
      -                ],
      -                "type": "string"
      -              },
      -              "widthMm": {
      -                "default": 50,
      -                "maximum": 90,
      -                "minimum": 20,
      -                "type": "number"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "chrome": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "dateLine": {
      -                "type": "boolean"
      -              },
      -              "recipientBlock": {
      -                "type": "boolean"
      -              },
      -              "subjectLine": {
      -                "type": "boolean"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "continuation": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "enabled": {
      -                "default": false,
      -                "type": "boolean"
      -              },
      -              "headerLine": {
      -                "default": true,
      -                "type": "boolean"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "documentMode": {
      -            "enum": [
      -              "letter",
      -              "form"
      -            ],
      -            "type": "string"
      -          },
      -          "falzmarken": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "enabled": {
      -                "default": false,
      -                "type": "boolean"
      -              },
      -              "falz": {
      -                "default": true,
      -                "type": "boolean"
      -              },
      -              "lochmarke": {
      -                "default": true,
      -                "type": "boolean"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "infoblock": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "enabled": {
      -                "default": false,
      -                "type": "boolean"
      -              },
      -              "fontSizePt": {
      -                "default": 8,
      -                "maximum": 10,
      -                "minimum": 7,
      -                "type": "number"
      -              },
      -              "labelWidthMm": {
      -                "default": 28,
      -                "maximum": 40,
      -                "minimum": 15,
      -                "type": "number"
      -              },
      -              "rows": {
      -                "items": {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "key": {
      -                      "pattern": "^[a-z][a-z0-9_]{0,30}$",
      -                      "type": "string"
      -                    },
      -                    "label": {
      -                      "maxLength": 120,
      -                      "minLength": 1,
      -                      "type": "string"
      -                    },
      -                    "staticValue": {
      -                      "anyOf": [
      -                        {
      -                          "maxLength": 200,
      -                          "type": "string"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ]
      -                    }
      -                  },
      -                  "required": [
      -                    "key",
      -                    "label"
      -                  ],
      -                  "type": "object"
      -                },
      -                "maxItems": 12,
      -                "minItems": 1,
      -                "type": "array"
      -              },
      -              "topMm": {
      -                "default": 45,
      -                "maximum": 90,
      -                "minimum": 32,
      -                "type": "number"
      -              },
      -              "valueWidthMm": {
      -                "default": 37,
      -                "maximum": 55,
      -                "minimum": 20,
      -                "type": "number"
      -              },
      -              "xMm": {
      -                "default": 125,
      -                "maximum": 170,
      -                "minimum": 118,
      -                "type": "number"
      -              }
      -            },
      -            "required": [
      -              "rows"
      -            ],
      -            "type": "object"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "schemaVersion": {
      -        "const": 2,
      -        "type": "number"
      -      },
      -      "zones": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "continuationHeader": {
      -            "$ref": "#/$defs/letterDesignV2Zone"
      -          },
      -          "footer": {
      -            "$ref": "#/$defs/letterDesignV2Zone"
      -          },
      -          "header": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "elements": {
      -                "default": [],
      -                "items": {
      -                  "oneOf": [
      -                    {
      -                      "additionalProperties": false,
      -                      "allOf": [
      -                        {
      -                          "if": {
      -                            "properties": {
      -                              "source": {
      -                                "const": "asset"
      -                              }
      -                            },
      -                            "required": [
      -                              "source"
      -                            ]
      -                          },
      -                          "then": {
      -                            "properties": {
      -                              "assetId": {
      -                                "format": "uuid",
      -                                "type": "string"
      -                              }
      -                            },
      -                            "required": [
      -                              "assetId"
      -                            ]
      -                          }
      -                        }
      -                      ],
      -                      "properties": {
      -                        "anchor": {
      -                          "default": "top-left",
      -                          "enum": [
      -                            "top-left",
      -                            "top-center",
      -                            "top-right",
      -                            "center-left",
      -                            "center",
      -                            "center-right",
      -                            "bottom-left",
      -                            "bottom-center",
      -                            "bottom-right"
      -                          ],
      -                          "type": "string"
      -                        },
      -                        "assetId": {
      -                          "anyOf": [
      -                            {
      -                              "format": "uuid",
      -                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ]
      -                        },
      -                        "fit": {
      -                          "default": "contain",
      -                          "enum": [
      -                            "contain",
      -                            "cover",
      -                            "stretch"
      -                          ],
      -                          "type": "string"
      -                        },
      -                        "heightMm": {
      -                          "exclusiveMinimum": 0,
      -                          "maximum": 297,
      -                          "type": "number"
      -                        },
      -                        "id": {
      -                          "pattern": "^[a-z][a-z0-9_-]{0,63}$",
      -                          "type": "string"
      -                        },
      -                        "offsetXMm": {
      -                          "default": 0,
      -                          "maximum": 210,
      -                          "minimum": -210,
      -                          "type": "number"
      -                        },
      -                        "offsetYMm": {
      -                          "default": 0,
      -                          "maximum": 297,
      -                          "minimum": -297,
      -                          "type": "number"
      -                        },
      -                        "rotationDeg": {
      -                          "anyOf": [
      -                            {
      -                              "const": 0,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 90,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 180,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 270,
      -                              "type": "number"
      -                            }
      -                          ],
      -                          "default": 0
      -                        },
      -                        "source": {
      -                          "enum": [
      -                            "asset",
      -                            "brand.logo",
      -                            "brand.logoDark"
      -                          ],
      -                          "type": "string"
      -                        },
      -                        "type": {
      -                          "const": "image",
      -                          "type": "string"
      -                        },
      -                        "widthMm": {
      -                          "exclusiveMinimum": 0,
      -                          "maximum": 210,
      -                          "type": "number"
      -                        },
      -                        "zOrder": {
      -                          "default": 0,
      -                          "maximum": 100,
      -                          "minimum": -100,
      -                          "type": "integer"
      -                        }
      -                      },
      -                      "required": [
      -                        "id",
      -                        "widthMm",
      -                        "heightMm",
      -                        "type",
      -                        "source"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "anchor": {
      -                          "default": "top-left",
      -                          "enum": [
      -                            "top-left",
      -                            "top-center",
      -                            "top-right",
      -                            "center-left",
      -                            "center",
      -                            "center-right",
      -                            "bottom-left",
      -                            "bottom-center",
      -                            "bottom-right"
      -                          ],
      -                          "type": "string"
      -                        },
      -                        "contentMode": {
      -                          "default": "template",
      -                          "enum": [
      -                            "template"
      -                          ],
      -                          "type": "string"
      -                        },
      -                        "heightMm": {
      -                          "exclusiveMinimum": 0,
      -                          "maximum": 297,
      -                          "type": "number"
      -                        },
      -                        "id": {
      -                          "pattern": "^[a-z][a-z0-9_-]{0,63}$",
      -                          "type": "string"
      -                        },
      -                        "offsetXMm": {
      -                          "default": 0,
      -                          "maximum": 210,
      -                          "minimum": -210,
      -                          "type": "number"
      -                        },
      -                        "offsetYMm": {
      -                          "default": 0,
      -                          "maximum": 297,
      -                          "minimum": -297,
      -                          "type": "number"
      -                        },
      -                        "rotationDeg": {
      -                          "anyOf": [
      -                            {
      -                              "const": 0,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 90,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 180,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 270,
      -                              "type": "number"
      -                            }
      -                          ],
      -                          "default": 0
      -                        },
      -                        "style": {
      -                          "additionalProperties": false,
      -                          "properties": {
      -                            "align": {
      -                              "default": "left",
      -                              "enum": [
      -                                "left",
      -                                "center",
      -                                "right"
      -                              ],
      -                              "type": "string"
      -                            },
      -                            "case": {
      -                              "default": "none",
      -                              "enum": [
      -                                "none",
      -                                "upper",
      -                                "lower",
      -                                "title"
      -                              ],
      -                              "type": "string"
      -                            },
      -                            "color": {
      -                              "anyOf": [
      -                                {
      -                                  "additionalProperties": false,
      -                                  "properties": {
      -                                    "b": {
      -                                      "maximum": 1,
      -                                      "minimum": 0,
      -                                      "type": "number"
      -                                    },
      -                                    "g": {
      -                                      "maximum": 1,
      -                                      "minimum": 0,
      -                                      "type": "number"
      -                                    },
      -                                    "r": {
      -                                      "maximum": 1,
      -                                      "minimum": 0,
      -                                      "type": "number"
      -                                    }
      -                                  },
      -                                  "required": [
      -                                    "r",
      -                                    "g",
      -                                    "b"
      -                                  ],
      -                                  "type": "object"
      -                                },
      -                                {
      -                                  "additionalProperties": false,
      -                                  "properties": {
      -                                    "token": {
      -                                      "enum": [
      -                                        "brand.primary",
      -                                        "brand.accent",
      -                                        "brand.text"
      -                                      ],
      -                                      "type": "string"
      -                                    }
      -                                  },
      -                                  "required": [
      -                                    "token"
      -                                  ],
      -                                  "type": "object"
      -                                }
      -                              ]
      -                            },
      -                            "family": {
      -                              "anyOf": [
      -                                {
      -                                  "enum": [
      -                                    "serif",
      -                                    "humanist-sans",
      -                                    "grotesk",
      -                                    "mono"
      -                                  ],
      -                                  "type": "string"
      -                                },
      -                                {
      -                                  "additionalProperties": false,
      -                                  "properties": {
      -                                    "token": {
      -                                      "const": "brand.font",
      -                                      "type": "string"
      -                                    }
      -                                  },
      -                                  "required": [
      -                                    "token"
      -                                  ],
      -                                  "type": "object"
      -                                }
      -                              ]
      -                            },
      -                            "letterSpacing": {
      -                              "default": 0,
      -                              "maximum": 10,
      -                              "minimum": -2,
      -                              "type": "number"
      -                            },
      -                            "lineHeightPt": {
      -                              "maximum": 100,
      -                              "minimum": 5,
      -                              "type": "number"
      -                            },
      -                            "sizePt": {
      -                              "maximum": 72,
      -                              "minimum": 5,
      -                              "type": "number"
      -                            },
      -                            "weight": {
      -                              "default": "regular",
      -                              "enum": [
      -                                "regular",
      -                                "medium",
      -                                "semibold",
      -                                "bold"
      -                              ],
      -                              "type": "string"
      -                            }
      -                          },
      -                          "required": [
      -                            "family",
      -                            "sizePt",
      -                            "lineHeightPt",
      -                            "color"
      -                          ],
      -                          "type": "object"
      -                        },
      -                        "text": {
      -                          "maxLength": 4000,
      -                          "minLength": 1,
      -                          "type": "string"
      -                        },
      -                        "type": {
      -                          "const": "text",
      -                          "type": "string"
      -                        },
      -                        "widthMm": {
      -                          "exclusiveMinimum": 0,
      -                          "maximum": 210,
      -                          "type": "number"
      -                        },
      -                        "zOrder": {
      -                          "default": 0,
      -                          "maximum": 100,
      -                          "minimum": -100,
      -                          "type": "integer"
      -                        }
      -                      },
      -                      "required": [
      -                        "id",
      -                        "widthMm",
      -                        "heightMm",
      -                        "type",
      -                        "text",
      -                        "style"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "anchor": {
      -                          "default": "top-left",
      -                          "enum": [
      -                            "top-left",
      -                            "top-center",
      -                            "top-right",
      -                            "center-left",
      -                            "center",
      -                            "center-right",
      -                            "bottom-left",
      -                            "bottom-center",
      -                            "bottom-right"
      -                          ],
      -                          "type": "string"
      -                        },
      -                        "color": {
      -                          "anyOf": [
      -                            {
      -                              "additionalProperties": false,
      -                              "properties": {
      -                                "b": {
      -                                  "maximum": 1,
      -                                  "minimum": 0,
      -                                  "type": "number"
      -                                },
      -                                "g": {
      -                                  "maximum": 1,
      -                                  "minimum": 0,
      -                                  "type": "number"
      -                                },
      -                                "r": {
      -                                  "maximum": 1,
      -                                  "minimum": 0,
      -                                  "type": "number"
      -                                }
      -                              },
      -                              "required": [
      -                                "r",
      -                                "g",
      -                                "b"
      -                              ],
      -                              "type": "object"
      -                            },
      -                            {
      -                              "additionalProperties": false,
      -                              "properties": {
      -                                "token": {
      -                                  "enum": [
      -                                    "brand.primary",
      -                                    "brand.accent",
      -                                    "brand.text"
      -                                  ],
      -                                  "type": "string"
      -                                }
      -                              },
      -                              "required": [
      -                                "token"
      -                              ],
      -                              "type": "object"
      -                            }
      -                          ]
      -                        },
      -                        "heightMm": {
      -                          "exclusiveMinimum": 0,
      -                          "maximum": 297,
      -                          "type": "number"
      -                        },
      -                        "id": {
      -                          "pattern": "^[a-z][a-z0-9_-]{0,63}$",
      -                          "type": "string"
      -                        },
      -                        "offsetXMm": {
      -                          "default": 0,
      -                          "maximum": 210,
      -                          "minimum": -210,
      -                          "type": "number"
      -                        },
      -                        "offsetYMm": {
      -                          "default": 0,
      -                          "maximum": 297,
      -                          "minimum": -297,
      -                          "type": "number"
      -                        },
      -                        "orientation": {
      -                          "enum": [
      -                            "horizontal",
      -                            "vertical"
      -                          ],
      -                          "type": "string"
      -                        },
      -                        "rotationDeg": {
      -                          "anyOf": [
      -                            {
      -                              "const": 0,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 90,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 180,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 270,
      -                              "type": "number"
      -                            }
      -                          ],
      -                          "default": 0
      -                        },
      -                        "thicknessMm": {
      -                          "maximum": 10,
      -                          "minimum": 0.1,
      -                          "type": "number"
      -                        },
      -                        "type": {
      -                          "const": "rule",
      -                          "type": "string"
      -                        },
      -                        "widthMm": {
      -                          "exclusiveMinimum": 0,
      -                          "maximum": 210,
      -                          "type": "number"
      -                        },
      -                        "zOrder": {
      -                          "default": 0,
      -                          "maximum": 100,
      -                          "minimum": -100,
      -                          "type": "integer"
      -                        }
      -                      },
      -                      "required": [
      -                        "id",
      -                        "widthMm",
      -                        "heightMm",
      -                        "type",
      -                        "orientation",
      -                        "thicknessMm",
      -                        "color"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    {
      -                      "additionalProperties": false,
      -                      "anyOf": [
      -                        {
      -                          "required": [
      -                            "fillColor"
      -                          ]
      -                        },
      -                        {
      -                          "required": [
      -                            "strokeColor"
      -                          ]
      -                        }
      -                      ],
      -                      "dependentRequired": {
      -                        "strokeWidthMm": [
      -                          "strokeColor"
      -                        ]
      -                      },
      -                      "properties": {
      -                        "anchor": {
      -                          "default": "top-left",
      -                          "enum": [
      -                            "top-left",
      -                            "top-center",
      -                            "top-right",
      -                            "center-left",
      -                            "center",
      -                            "center-right",
      -                            "bottom-left",
      -                            "bottom-center",
      -                            "bottom-right"
      -                          ],
      -                          "type": "string"
      -                        },
      -                        "cornerRadiusMm": {
      -                          "default": 0,
      -                          "maximum": 50,
      -                          "minimum": 0,
      -                          "type": "number"
      -                        },
      -                        "fillColor": {
      -                          "anyOf": [
      -                            {
      -                              "additionalProperties": false,
      -                              "properties": {
      -                                "b": {
      -                                  "maximum": 1,
      -                                  "minimum": 0,
      -                                  "type": "number"
      -                                },
      -                                "g": {
      -                                  "maximum": 1,
      -                                  "minimum": 0,
      -                                  "type": "number"
      -                                },
      -                                "r": {
      -                                  "maximum": 1,
      -                                  "minimum": 0,
      -                                  "type": "number"
      -                                }
      -                              },
      -                              "required": [
      -                                "r",
      -                                "g",
      -                                "b"
      -                              ],
      -                              "type": "object"
      -                            },
      -                            {
      -                              "additionalProperties": false,
      -                              "properties": {
      -                                "token": {
      -                                  "enum": [
      -                                    "brand.primary",
      -                                    "brand.accent",
      -                                    "brand.text"
      -                                  ],
      -                                  "type": "string"
      -                                }
      -                              },
      -                              "required": [
      -                                "token"
      -                              ],
      -                              "type": "object"
      -                            }
      -                          ]
      -                        },
      -                        "heightMm": {
      -                          "exclusiveMinimum": 0,
      -                          "maximum": 297,
      -                          "type": "number"
      -                        },
      -                        "id": {
      -                          "pattern": "^[a-z][a-z0-9_-]{0,63}$",
      -                          "type": "string"
      -                        },
      -                        "offsetXMm": {
      -                          "default": 0,
      -                          "maximum": 210,
      -                          "minimum": -210,
      -                          "type": "number"
      -                        },
      -                        "offsetYMm": {
      -                          "default": 0,
      -                          "maximum": 297,
      -                          "minimum": -297,
      -                          "type": "number"
      -                        },
      -                        "rotationDeg": {
      -                          "anyOf": [
      -                            {
      -                              "const": 0,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 90,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 180,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 270,
      -                              "type": "number"
      -                            }
      -                          ],
      -                          "default": 0
      -                        },
      -                        "strokeColor": {
      -                          "anyOf": [
      -                            {
      -                              "additionalProperties": false,
      -                              "properties": {
      -                                "b": {
      -                                  "maximum": 1,
      -                                  "minimum": 0,
      -                                  "type": "number"
      -                                },
      -                                "g": {
      -                                  "maximum": 1,
      -                                  "minimum": 0,
      -                                  "type": "number"
      -                                },
      -                                "r": {
      -                                  "maximum": 1,
      -                                  "minimum": 0,
      -                                  "type": "number"
      -                                }
      -                              },
      -                              "required": [
      -                                "r",
      -                                "g",
      -                                "b"
      -                              ],
      -                              "type": "object"
      -                            },
      -                            {
      -                              "additionalProperties": false,
      -                              "properties": {
      -                                "token": {
      -                                  "enum": [
      -                                    "brand.primary",
      -                                    "brand.accent",
      -                                    "brand.text"
      -                                  ],
      -                                  "type": "string"
      -                                }
      -                              },
      -                              "required": [
      -                                "token"
      -                              ],
      -                              "type": "object"
      -                            }
      -                          ]
      -                        },
      -                        "strokeWidthMm": {
      -                          "maximum": 10,
      -                          "minimum": 0.1,
      -                          "type": "number"
      -                        },
      -                        "type": {
      -                          "const": "box",
      -                          "type": "string"
      -                        },
      -                        "widthMm": {
      -                          "exclusiveMinimum": 0,
      -                          "maximum": 210,
      -                          "type": "number"
      -                        },
      -                        "zOrder": {
      -                          "default": 0,
      -                          "maximum": 100,
      -                          "minimum": -100,
      -                          "type": "integer"
      -                        }
      -                      },
      -                      "required": [
      -                        "id",
      -                        "widthMm",
      -                        "heightMm",
      -                        "type"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "anchor": {
      -                          "default": "top-left",
      -                          "enum": [
      -                            "top-left",
      -                            "top-center",
      -                            "top-right",
      -                            "center-left",
      -                            "center",
      -                            "center-right",
      -                            "bottom-left",
      -                            "bottom-center",
      -                            "bottom-right"
      -                          ],
      -                          "type": "string"
      -                        },
      -                        "heightMm": {
      -                          "exclusiveMinimum": 0,
      -                          "maximum": 297,
      -                          "type": "number"
      -                        },
      -                        "id": {
      -                          "pattern": "^[a-z][a-z0-9_-]{0,63}$",
      -                          "type": "string"
      -                        },
      -                        "offsetXMm": {
      -                          "default": 0,
      -                          "maximum": 210,
      -                          "minimum": -210,
      -                          "type": "number"
      -                        },
      -                        "offsetYMm": {
      -                          "default": 0,
      -                          "maximum": 297,
      -                          "minimum": -297,
      -                          "type": "number"
      -                        },
      -                        "rotationDeg": {
      -                          "anyOf": [
      -                            {
      -                              "const": 0,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 90,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 180,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 270,
      -                              "type": "number"
      -                            }
      -                          ],
      -                          "default": 0
      -                        },
      -                        "type": {
      -                          "const": "spacer",
      -                          "type": "string"
      -                        },
      -                        "widthMm": {
      -                          "exclusiveMinimum": 0,
      -                          "maximum": 210,
      -                          "type": "number"
      -                        },
      -                        "zOrder": {
      -                          "default": 0,
      -                          "maximum": 100,
      -                          "minimum": -100,
      -                          "type": "integer"
      -                        }
      -                      },
      -                      "required": [
      -                        "id",
      -                        "widthMm",
      -                        "heightMm",
      -                        "type"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "anchor": {
      -                          "default": "top-left",
      -                          "enum": [
      -                            "top-left",
      -                            "top-center",
      -                            "top-right",
      -                            "center-left",
      -                            "center",
      -                            "center-right",
      -                            "bottom-left",
      -                            "bottom-center",
      -                            "bottom-right"
      -                          ],
      -                          "type": "string"
      -                        },
      -                        "backgroundColor": {
      -                          "anyOf": [
      -                            {
      -                              "additionalProperties": false,
      -                              "properties": {
      -                                "b": {
      -                                  "maximum": 1,
      -                                  "minimum": 0,
      -                                  "type": "number"
      -                                },
      -                                "g": {
      -                                  "maximum": 1,
      -                                  "minimum": 0,
      -                                  "type": "number"
      -                                },
      -                                "r": {
      -                                  "maximum": 1,
      -                                  "minimum": 0,
      -                                  "type": "number"
      -                                }
      -                              },
      -                              "required": [
      -                                "r",
      -                                "g",
      -                                "b"
      -                              ],
      -                              "type": "object"
      -                            },
      -                            {
      -                              "additionalProperties": false,
      -                              "properties": {
      -                                "token": {
      -                                  "enum": [
      -                                    "brand.primary",
      -                                    "brand.accent",
      -                                    "brand.text"
      -                                  ],
      -                                  "type": "string"
      -                                }
      -                              },
      -                              "required": [
      -                                "token"
      -                              ],
      -                              "type": "object"
      -                            }
      -                          ],
      -                          "default": {
      -                            "b": 1,
      -                            "g": 1,
      -                            "r": 1
      -                          }
      -                        },
      -                        "foregroundColor": {
      -                          "anyOf": [
      -                            {
      -                              "additionalProperties": false,
      -                              "properties": {
      -                                "b": {
      -                                  "maximum": 1,
      -                                  "minimum": 0,
      -                                  "type": "number"
      -                                },
      -                                "g": {
      -                                  "maximum": 1,
      -                                  "minimum": 0,
      -                                  "type": "number"
      -                                },
      -                                "r": {
      -                                  "maximum": 1,
      -                                  "minimum": 0,
      -                                  "type": "number"
      -                                }
      -                              },
      -                              "required": [
      -                                "r",
      -                                "g",
      -                                "b"
      -                              ],
      -                              "type": "object"
      -                            },
      -                            {
      -                              "additionalProperties": false,
      -                              "properties": {
      -                                "token": {
      -                                  "enum": [
      -                                    "brand.primary",
      -                                    "brand.accent",
      -                                    "brand.text"
      -                                  ],
      -                                  "type": "string"
      -                                }
      -                              },
      -                              "required": [
      -                                "token"
      -                              ],
      -                              "type": "object"
      -                            }
      -                          ],
      -                          "default": {
      -                            "b": 0,
      -                            "g": 0,
      -                            "r": 0
      -                          }
      -                        },
      -                        "format": {
      -                          "enum": [
      -                            "qr",
      -                            "code128"
      -                          ],
      -                          "type": "string"
      -                        },
      -                        "heightMm": {
      -                          "exclusiveMinimum": 0,
      -                          "maximum": 297,
      -                          "type": "number"
      -                        },
      -                        "id": {
      -                          "pattern": "^[a-z][a-z0-9_-]{0,63}$",
      -                          "type": "string"
      -                        },
      -                        "offsetXMm": {
      -                          "default": 0,
      -                          "maximum": 210,
      -                          "minimum": -210,
      -                          "type": "number"
      -                        },
      -                        "offsetYMm": {
      -                          "default": 0,
      -                          "maximum": 297,
      -                          "minimum": -297,
      -                          "type": "number"
      -                        },
      -                        "payloadTemplate": {
      -                          "maxLength": 512,
      -                          "minLength": 1,
      -                          "type": "string"
      -                        },
      -                        "rotationDeg": {
      -                          "anyOf": [
      -                            {
      -                              "const": 0,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 90,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 180,
      -                              "type": "number"
      -                            },
      -                            {
      -                              "const": 270,
      -                              "type": "number"
      -                            }
      -                          ],
      -                          "default": 0
      -                        },
      -                        "type": {
      -                          "const": "barcode",
      -                          "type": "string"
      -                        },
      -                        "widthMm": {
      -                          "exclusiveMinimum": 0,
      -                          "maximum": 210,
      -                          "type": "number"
      -                        },
      -                        "zOrder": {
      -                          "default": 0,
      -                          "maximum": 100,
      -                          "minimum": -100,
      -                          "type": "integer"
      -                        }
      -                      },
      -                      "required": [
      -                        "id",
      -                        "widthMm",
      -                        "heightMm",
      -                        "type",
      -                        "format",
      -                        "payloadTemplate"
      -                      ],
      -                      "type": "object"
      -                    }
      -                  ]
      -                },
      -                "maxItems": 64,
      -                "type": "array"
      -              },
      -              "reservedBox": {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "heightMm": {
      -                    "exclusiveMinimum": 0,
      -                    "maximum": 297,
      -                    "type": "number"
      -                  },
      -                  "widthMm": {
      -                    "exclusiveMinimum": 0,
      -                    "maximum": 210,
      -                    "type": "number"
      -                  },
      -                  "xMm": {
      -                    "maximum": 210,
      -                    "minimum": 0,
      -                    "type": "number"
      -                  },
      -                  "yMm": {
      -                    "maximum": 297,
      -                    "minimum": 0,
      -                    "type": "number"
      -                  }
      -                },
      -                "required": [
      -                  "xMm",
      -                  "yMm",
      -                  "widthMm",
      -                  "heightMm"
      -                ],
      -                "type": "object"
      -              }
      -            },
      -            "required": [
      -              "reservedBox"
      -            ],
      -            "type": "object"
      -          },
      -          "sidebar": {
      -            "$ref": "#/$defs/letterDesignV2Zone"
      -          },
      -          "watermark": {
      -            "$ref": "#/$defs/letterDesignV2Zone"
      -          }
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "schemaVersion",
      -      "zones",
      -      "body"
      -    ],
      -    "semanticValidation": {
      -      "authority": "designV2Schema (Zod runtime)",
      -      "runtimeOnly": [
      -        "template placeholder grammar",
      -        "element ids unique across zones",
      -        "reservedBox xMm + widthMm <= 210 and yMm + heightMm <= 297",
      -        "anchored element rectangle remains within 210 x 297 mm A4",
      -        "v1 compatibility payloads are internal migration output and are rejected by native authoring"
      -      ]
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "barcode": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "enabled": {
      +            "default": false,
      +            "type": "boolean"
      +          },
      +          "marginRightYMm": {
      +            "default": 100,
      +            "maximum": 270,
      +            "minimum": 92,
      +            "type": "number"
      +          },
      +          "payloadTemplate": {
      +            "maxLength": 512,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "placement": {
      +            "default": "infoblock",
      +            "enum": [
      +              "infoblock",
      +              "footer-right",
      +              "margin-right"
      +            ],
      +            "type": "string"
      +          },
      +          "sizeMm": {
      +            "default": 22,
      +            "maximum": 40,
      +            "minimum": 12,
      +            "type": "number"
      +          },
      +          "type": {
      +            "default": "qr",
      +            "enum": [
      +              "qr",
      +              "code128"
      +            ],
      +            "type": "string"
      +          },
      +          "widthMm": {
      +            "default": 50,
      +            "maximum": 90,
      +            "minimum": 20,
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "chrome": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "dateLine": {
      +            "type": "boolean"
      +          },
      +          "recipientBlock": {
      +            "type": "boolean"
      +          },
      +          "subjectLine": {
      +            "type": "boolean"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "continuation": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "enabled": {
      +            "default": false,
      +            "type": "boolean"
      +          },
      +          "headerLine": {
      +            "default": true,
      +            "type": "boolean"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "documentMode": {
      +        "enum": [
      +          "letter",
      +          "form"
      +        ],
      +        "type": "string"
      +      },
      +      "falzmarken": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "enabled": {
      +            "default": false,
      +            "type": "boolean"
      +          },
      +          "falz": {
      +            "default": true,
      +            "type": "boolean"
      +          },
      +          "lochmarke": {
      +            "default": true,
      +            "type": "boolean"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "footer": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "columns": {
      +            "items": {
      +              "items": {
      +                "maxLength": 120,
      +                "type": "string"
      +              },
      +              "maxItems": 8,
      +              "minItems": 1,
      +              "type": "array"
      +            },
      +            "maxItems": 4,
      +            "minItems": 1,
      +            "type": "array"
      +          },
      +          "enabled": {
      +            "default": false,
      +            "type": "boolean"
      +          },
      +          "fontSizePt": {
      +            "default": 7,
      +            "maximum": 9,
      +            "minimum": 6,
      +            "type": "number"
      +          },
      +          "scope": {
      +            "default": "first-page",
      +            "enum": [
      +              "first-page",
      +              "all-letter-pages"
      +            ],
      +            "type": "string"
      +          },
      +          "topMm": {
      +            "default": 272,
      +            "maximum": 285,
      +            "minimum": 250,
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "columns"
      +        ],
      +        "type": "object"
      +      },
      +      "header": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "heightMm": {
      +            "maximum": 120,
      +            "minimum": 5,
      +            "type": "number"
      +          },
      +          "letterheadId": {
      +            "anyOf": [
      +              {
      +                "format": "uuid",
      +                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "offsetXMm": {
      +            "default": 0,
      +            "maximum": 170,
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "offsetYMm": {
      +            "default": 8,
      +            "maximum": 40,
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "placement": {
      +            "default": "top",
      +            "enum": [
      +              "top",
      +              "logo-right",
      +              "full"
      +            ],
      +            "type": "string"
      +          },
      +          "replaceSenderBlock": {
      +            "default": false,
      +            "type": "boolean"
      +          },
      +          "widthMm": {
      +            "default": 165,
      +            "maximum": 210,
      +            "minimum": 10,
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "infoblock": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "enabled": {
      +            "default": false,
      +            "type": "boolean"
      +          },
      +          "fontSizePt": {
      +            "default": 8,
      +            "maximum": 10,
      +            "minimum": 7,
      +            "type": "number"
      +          },
      +          "labelWidthMm": {
      +            "default": 28,
      +            "maximum": 40,
      +            "minimum": 15,
      +            "type": "number"
      +          },
      +          "rows": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "key": {
      +                  "pattern": "^[a-z][a-z0-9_]{0,30}$",
      +                  "type": "string"
      +                },
      +                "label": {
      +                  "maxLength": 120,
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "staticValue": {
      +                  "anyOf": [
      +                    {
      +                      "maxLength": 200,
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "key",
      +                "label"
      +              ],
      +              "type": "object"
      +            },
      +            "maxItems": 12,
      +            "minItems": 1,
      +            "type": "array"
      +          },
      +          "topMm": {
      +            "default": 45,
      +            "maximum": 90,
      +            "minimum": 32,
      +            "type": "number"
      +          },
      +          "valueWidthMm": {
      +            "default": 37,
      +            "maximum": 55,
      +            "minimum": 20,
      +            "type": "number"
      +          },
      +          "xMm": {
      +            "default": 125,
      +            "maximum": 170,
      +            "minimum": 118,
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "rows"
      +        ],
      +        "type": "object"
      +      },
      +      "marginText": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "fontSizePt": {
      +            "default": 6,
      +            "maximum": 9,
      +            "minimum": 5,
      +            "type": "number"
      +          },
      +          "rotationDeg": {
      +            "anyOf": [
      +              {
      +                "const": 90,
      +                "type": "number"
      +              },
      +              {
      +                "const": 270,
      +                "type": "number"
      +              }
      +            ],
      +            "default": 90
      +          },
      +          "side": {
      +            "default": "left",
      +            "enum": [
      +              "left",
      +              "right"
      +            ],
      +            "type": "string"
      +          },
      +          "text": {
      +            "maxLength": 160,
      +            "minLength": 1,
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "text"
      +        ],
      +        "type": "object"
      +      },
      +      "schemaVersion": {
      +        "const": 1,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "schemaVersion"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "description": "Native v2 authoring schema. Standard JSON Schema covers shape, defaults, native enums, asset and box dependencies. Runtime Zod validation remains authoritative for template grammar, duplicate element ids, and arithmetic A4 placement.",
      +    "properties": {
      +      "body": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "font": {
      +            "anyOf": [
      +              {
      +                "enum": [
      +                  "serif",
      +                  "humanist-sans",
      +                  "grotesk",
      +                  "mono"
      +                ],
      +                "type": "string"
      +              },
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "token": {
      +                    "const": "brand.font",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "token"
      +                ],
      +                "type": "object"
      +              }
      +            ]
      +          },
      +          "lineHeightPt": {
      +            "maximum": 30,
      +            "minimum": 7,
      +            "type": "number"
      +          },
      +          "senderBlockStyle": {
      +            "default": "inherit",
      +            "enum": [
      +              "inherit",
      +              "compact",
      +              "hidden"
      +            ],
      +            "type": "string"
      +          },
      +          "sizePt": {
      +            "maximum": 18,
      +            "minimum": 6,
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "font",
      +          "sizePt",
      +          "lineHeightPt"
      +        ],
      +        "type": "object"
      +      },
      +      "furniture": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "barcode": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "enabled": {
      +                "default": false,
      +                "type": "boolean"
      +              },
      +              "marginRightYMm": {
      +                "default": 100,
      +                "maximum": 270,
      +                "minimum": 92,
      +                "type": "number"
      +              },
      +              "payloadTemplate": {
      +                "maxLength": 512,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "placement": {
      +                "default": "infoblock",
      +                "enum": [
      +                  "infoblock",
      +                  "footer-right",
      +                  "margin-right"
      +                ],
      +                "type": "string"
      +              },
      +              "sizeMm": {
      +                "default": 22,
      +                "maximum": 40,
      +                "minimum": 12,
      +                "type": "number"
      +              },
      +              "type": {
      +                "default": "qr",
      +                "enum": [
      +                  "qr",
      +                  "code128"
      +                ],
      +                "type": "string"
      +              },
      +              "widthMm": {
      +                "default": 50,
      +                "maximum": 90,
      +                "minimum": 20,
      +                "type": "number"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "chrome": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "dateLine": {
      +                "type": "boolean"
      +              },
      +              "recipientBlock": {
      +                "type": "boolean"
      +              },
      +              "subjectLine": {
      +                "type": "boolean"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "continuation": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "enabled": {
      +                "default": false,
      +                "type": "boolean"
      +              },
      +              "headerLine": {
      +                "default": true,
      +                "type": "boolean"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "documentMode": {
      +            "enum": [
      +              "letter",
      +              "form"
      +            ],
      +            "type": "string"
      +          },
      +          "falzmarken": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "enabled": {
      +                "default": false,
      +                "type": "boolean"
      +              },
      +              "falz": {
      +                "default": true,
      +                "type": "boolean"
      +              },
      +              "lochmarke": {
      +                "default": true,
      +                "type": "boolean"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "infoblock": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "enabled": {
      +                "default": false,
      +                "type": "boolean"
      +              },
      +              "fontSizePt": {
      +                "default": 8,
      +                "maximum": 10,
      +                "minimum": 7,
      +                "type": "number"
      +              },
      +              "labelWidthMm": {
      +                "default": 28,
      +                "maximum": 40,
      +                "minimum": 15,
      +                "type": "number"
      +              },
      +              "rows": {
      +                "items": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "key": {
      +                      "pattern": "^[a-z][a-z0-9_]{0,30}$",
      +                      "type": "string"
      +                    },
      +                    "label": {
      +                      "maxLength": 120,
      +                      "minLength": 1,
      +                      "type": "string"
      +                    },
      +                    "staticValue": {
      +                      "anyOf": [
      +                        {
      +                          "maxLength": 200,
      +                          "type": "string"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    }
      +                  },
      +                  "required": [
      +                    "key",
      +                    "label"
      +                  ],
      +                  "type": "object"
      +                },
      +                "maxItems": 12,
      +                "minItems": 1,
      +                "type": "array"
      +              },
      +              "topMm": {
      +                "default": 45,
      +                "maximum": 90,
      +                "minimum": 32,
      +                "type": "number"
      +              },
      +              "valueWidthMm": {
      +                "default": 37,
      +                "maximum": 55,
      +                "minimum": 20,
      +                "type": "number"
      +              },
      +              "xMm": {
      +                "default": 125,
      +                "maximum": 170,
      +                "minimum": 118,
      +                "type": "number"
      +              }
      +            },
      +            "required": [
      +              "rows"
      +            ],
      +            "type": "object"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "schemaVersion": {
      +        "const": 2,
      +        "type": "number"
      +      },
      +      "zones": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "continuationHeader": {
      +            "$ref": "#/$defs/letterDesignV2Zone"
      +          },
      +          "footer": {
      +            "$ref": "#/$defs/letterDesignV2Zone"
      +          },
      +          "header": {
      +            "$ref": "#/$defs/letterDesignV2Zone"
      +          },
      +          "sidebar": {
      +            "$ref": "#/$defs/letterDesignV2Zone"
      +          },
      +          "watermark": {
      +            "$ref": "#/$defs/letterDesignV2Zone"
      +          }
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "schemaVersion",
      +      "zones",
      +      "body"
      +    ],
      +    "semanticValidation": {
      +      "authority": "designV2Schema (Zod runtime)",
      +      "runtimeOnly": [
      +        "template placeholder grammar",
      +        "element ids unique across zones",
      +        "reservedBox xMm + widthMm <= 210 and yMm + heightMm <= 297",
      +        "anchored element rectangle remains within 210 x 297 mm A4",
      +        "v1 compatibility payloads are internal migration output and are rejected by native authoring"
      +      ]
      +    },
      +    "type": "object"
      +  }
      +]
  3. Changed1 schema field changed
    • changedInput schema / properties / brandingOwnershipConfirmed / description
      Previous value: -"Bei einer Neuanlage oder geaenderten Branding-Asset-Referenz zwingend true. Unveraenderte Folgespeicherungen brauchen keine erneute Bestaetigung. EN: Required as true when creating or changing a branding asset reference. Unchanged iterative saves need no renewed confirmation."New value: +"Bei einer Neuanlage oder geänderten Branding-Asset-Referenz zwingend true. Unveränderte Folgespeicherungen brauchen keine erneute Bestätigung. EN: Required as true when creating or changing a branding asset reference. Unchanged iterative saves need no renewed confirmation."
  4. First observed

TDQS

C2.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=false, destructiveHint=false and openWorldHint=false, so the description's added value is the statement that the design is fully validated and checked against postal clear zones before storage, plus the returned designId and source hash. However, for a write tool it omits the decisive behavior: whether saving with an existing name or designId overwrites an existing design, and whether errors are returned as validation failures. That absence limits it to a 3.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The core purpose is front-loaded in the first sentence, which is good. But every sentence is duplicated in German and English, and the line 'Der technische Tool-Name ist letter_design_save' is pure filler, roughly doubling the length without adding decision-relevant information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool wrapping a large nested design schema (v1 fields vs. v2 zones/elements/reservedBox), the description gives no orientation on which schema version to prefer or how the two branches differ, nor any save/update semantics. An agent can read the purpose but lacks enough to call this correctly on an existing design.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Only 40% schema description coverage across 5 parameters, and the description does not compensate. It alludes to name/design implicitly and to schemaVersion 1 vs 2, but never explains the critical designId parameter (create vs. update), what 'reasoning' is for, or why brandingOwnershipConfirmed must be true on new/changed branding references.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: saves a reusable schemaVersion 1/2 letterhead into the partner profile and returns designId plus source hash. It is clear what the tool does, but it never contrasts itself with nearby siblings such as letter_design_preview, letterhead_upload, preset_save or brand_kit_save, so an agent still has to infer the boundary itself.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no when-to-use / when-not-to-use guidance and no mention of prerequisites or alternatives. The sentence about the stationery later carrying cancellations, invoices and contracts is product context, not a condition that helps an agent choose this tool over letter_design_preview or letterhead_upload.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.