Skip to main content
Glama

HTML/CSS to Image API

List Template Versions

list_template_versions
Read-only

Lists saved versions of one template, newest first, with their content and rendering settings in data. Use this to inspect a template before updating it or select an older version for create_templated_image. Pass pagination.next_page_start as max_version to continue; stop when data is empty or the cursor is null.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
countYesRequired page size from 1 to 100; use 10 for an initial lookup.
max_versionNoExclusive version cursor. Omit for the newest versions; for the next page, pass pagination.next_page_start from the previous response unchanged.
template_idYesExact template ID returned by create_template or found in list_templates.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
dataNo
paginationNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / data / items / anyOf
      Previous value: -[
      -  {
      -    "description": "A template with template_type: html_css. Contains the saved HTML, CSS, and rendering settings. Supply template_values when rendering to substitute placeholder values; update the template to change the saved design.",
      -    "properties": {
      -      "color_scheme": {
      -        "description": "Stored light or dark color-scheme preference exposed to the rendered page's CSS.",
      -        "enum": [
      -          "light",
      -          "dark",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "created_at": {
      -        "description": "UTC timestamp when this template version was created.",
      -        "format": "date-time",
      -        "type": "string"
      -      },
      -      "css": {
      -        "description": "Saved CSS used to style the template. Handlebars substitutions are evaluated in html, so place dynamic style values there.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "description": {
      -        "description": "Optional notes about the template's purpose and intended use.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "device_scale": {
      -        "description": "Stored screenshot pixel ratio. For example, 2 produces two output pixels per CSS pixel in each dimension. Null uses the rendering default.",
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "disable_twemoji": {
      -        "description": "Whether native emoji rendering is used instead of Twemoji. Null leaves the rendering default in effect.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "google_fonts": {
      -        "description": "Google Font families loaded for this template, separated by |. The HTML or CSS must reference the families to use them.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "html": {
      -        "description": "Saved HTML source, including any Handlebars placeholders such as {{title}}. Pass matching values without braces, such as a title property in template_values, when rendering.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "id": {
      -        "description": "Unique template identifier used when rendering or updating this template.",
      -        "type": "string"
      -      },
      -      "jumbo_max_height": {
      -        "description": "Stored maximum output height in pixels for jumbo rendering. Used with jumbo_max_width; jumbo rendering consumes additional image credits.",
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "jumbo_max_width": {
      -        "description": "Stored maximum output width in pixels for jumbo rendering. Used with jumbo_max_height.",
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "max_wait_ms": {
      -        "description": "Stored loading-wait limit in milliseconds before capture.",
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "media_type": {
      -        "description": "Stored CSS media mode: print or screen.",
      -        "enum": [
      -          "print",
      -          "screen",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "ms_delay": {
      -        "description": "Stored additional delay in milliseconds before capture, used to allow client-side content to finish updating.",
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "name": {
      -        "description": "Optional display name for template discovery. Use id to identify the template in rendering and update requests.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "proxy_id": {
      -        "description": "Identifier of the configured organization proxy used for rendering. Proxy connection details are available through the proxy configuration.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "render_count": {
      -        "description": "Number of image creations recorded for this template version. Organization-wide image-credit usage is reported separately.",
      -        "type": "integer"
      -      },
      -      "render_when_ready": {
      -        "description": "Whether capture waits for the template's JavaScript to call ScreenshotReady(). When enabled, rendering fails if the readiness signal is never sent.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "selector": {
      -        "description": "CSS selector used to crop rendered images to an element. Preserve this setting when updating the template unless the intended crop changes.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "storage_destination_id": {
      -        "description": "Identifier of the configured destination for rendered files. The destination configuration specifies its provider, enabled state, and storage behavior.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "template_type": {
      -        "const": "html_css"
      -      },
      -      "timezone": {
      -        "description": "Stored IANA timezone identifier exposed to the rendered page, such as America/New_York or UTC.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "transparent_background": {
      -        "description": "Whether the browser's default background is transparent. Backgrounds explicitly painted by the template's HTML or CSS still apply.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "updated_at": {
      -        "description": "UTC timestamp when this template version was last updated.",
      -        "format": "date-time",
      -        "type": "string"
      -      },
      -      "version": {
      -        "description": "Saved template version identifier. Specify it when rendering to select this exact version.",
      -        "type": "integer"
      -      },
      -      "viewport_height": {
      -        "description": "Stored browser viewport height in CSS pixels. Used with viewport_width; setting both disables automatic cropping.",
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "viewport_landscape": {
      -        "description": "Whether the emulated viewport uses landscape orientation.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "viewport_mobile": {
      -        "description": "Whether mobile viewport emulation is enabled, including support for the page's meta viewport tag.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "viewport_touch": {
      -        "description": "Whether touch support is exposed to the rendered page.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "viewport_width": {
      -        "description": "Stored browser viewport width in CSS pixels. Used with viewport_height; output pixel dimensions also depend on device_scale.",
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      }
      -    }
      -  },
      -  {
      -    "description": "A template with template_type: blocks, authored in the visual template editor. Contains block counts and variable requirements for rendering. Edit the block design in the template editor.",
      -    "properties": {
      -      "block_counts": {
      -        "additionalProperties": {
      -          "type": "integer"
      -        },
      -        "description": "Number of blocks of each type in the saved design, keyed by block type name. This summarizes the design rather than exposing its editable block tree.",
      -        "type": "object"
      -      },
      -      "color_scheme": {
      -        "description": "Stored light or dark color-scheme preference exposed to the rendered page's CSS.",
      -        "enum": [
      -          "light",
      -          "dark",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "created_at": {
      -        "description": "UTC timestamp when this template version was created.",
      -        "format": "date-time",
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "Optional notes about the template's purpose and intended use.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "device_scale": {
      -        "description": "Stored screenshot pixel ratio. For example, 2 produces two output pixels per CSS pixel in each dimension. Null uses the rendering default.",
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "disable_twemoji": {
      -        "description": "Whether native emoji rendering is used instead of Twemoji. Null leaves the rendering default in effect.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "id": {
      -        "description": "Unique template identifier used when rendering or updating this template.",
      -        "type": "string"
      -      },
      -      "jumbo_max_height": {
      -        "description": "Stored maximum output height in pixels for jumbo rendering. Used with jumbo_max_width; jumbo rendering consumes additional image credits.",
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "jumbo_max_width": {
      -        "description": "Stored maximum output width in pixels for jumbo rendering. Used with jumbo_max_height.",
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "max_wait_ms": {
      -        "description": "Stored loading-wait limit in milliseconds before capture.",
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "media_type": {
      -        "description": "Stored CSS media mode: print or screen.",
      -        "enum": [
      -          "print",
      -          "screen",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "ms_delay": {
      -        "description": "Stored additional delay in milliseconds before capture, used to allow client-side content to finish updating.",
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "name": {
      -        "description": "Optional display name for template discovery. Use id to identify the template in rendering and update requests.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "proxy_id": {
      -        "description": "Identifier of the configured organization proxy used for rendering. Proxy connection details are available through the proxy configuration.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "render_count": {
      -        "description": "Number of image creations recorded for this template version. Organization-wide image-credit usage is reported separately.",
      -        "type": "integer"
      -      },
      -      "render_when_ready": {
      -        "description": "Whether capture waits for the template's JavaScript to call ScreenshotReady(). When enabled, rendering fails if the readiness signal is never sent.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "selector": {
      -        "description": "CSS selector used to crop rendered images to an element. Preserve this setting when updating the template unless the intended crop changes.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "storage_destination_id": {
      -        "description": "Identifier of the configured destination for rendered files. The destination configuration specifies its provider, enabled state, and storage behavior.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "template_type": {
      -        "const": "blocks"
      -      },
      -      "timezone": {
      -        "description": "Stored IANA timezone identifier exposed to the rendered page, such as America/New_York or UTC.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "transparent_background": {
      -        "description": "Whether the browser's default background is transparent. Backgrounds explicitly painted by the template's HTML or CSS still apply.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "updated_at": {
      -        "description": "UTC timestamp when this template version was last updated.",
      -        "format": "date-time",
      -        "type": "string"
      -      },
      -      "variables": {
      -        "description": "Discovered template variables and their value requirements. Use these entries to prepare template_values for a rendering request.",
      -        "items": {
      -          "description": "A variable discovered in a block template, with its key, requirement mode, inferred value kind, and any fallback or helper context.",
      -          "properties": {
      -            "fallback_value": {
      -              "description": "Saved fallback JSON value used when the variable is missing and its mode selects fallback behavior. Preserve its JSON value type when supplying an override."
      -            },
      -            "helper_kind": {
      -              "description": "Handlebars helper context used during value validation, such as if, unless, with, or each. Interpret this together with mode and kind_hint when preparing template_values.",
      -              "enum": [
      -                "UNKNOWN",
      -                "None",
      -                "If",
      -                "Unless",
      -                "With",
      -                "Each"
      -              ],
      -              "type": "string"
      -            },
      -            "key": {
      -              "description": "Variable name or path used in template_values, without Handlebars braces. Preserve its casing and nesting when supplying values.",
      -              "type": "string"
      -            },
      -            "kind_hint": {
      -              "description": "Inferred value kind, such as string, boolean, integer, color, object, or collection. Use it to choose an appropriate JSON value; an unknown kind provides no type guidance.",
      -              "enum": [
      -                "UNKNOWN",
      -                "String",
      -                "Boolean",
      -                "Integer",
      -                "Float",
      -                "Color",
      -                "Size",
      -                "Object",
      -                "Collection"
      -              ],
      -              "type": "string"
      -            },
      -            "mode": {
      -              "description": "Whether the template variable is required, ignored, or has a fallback value.",
      -              "enum": [
      -                "Required",
      -                "Ignore",
      -                "Fallback"
      -              ],
      -              "type": "string"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "version": {
      -        "description": "Saved template version identifier. Specify it when rendering to select this exact version.",
      -        "type": "integer"
      -      },
      -      "viewport_height": {
      -        "description": "Stored browser viewport height in CSS pixels. Used with viewport_width; setting both disables automatic cropping.",
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "viewport_landscape": {
      -        "description": "Whether the emulated viewport uses landscape orientation.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "viewport_mobile": {
      -        "description": "Whether mobile viewport emulation is enabled, including support for the page's meta viewport tag.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "viewport_touch": {
      -        "description": "Whether touch support is exposed to the rendered page.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "viewport_width": {
      -        "description": "Stored browser viewport width in CSS pixels. Used with viewport_height; output pixel dimensions also depend on device_scale.",
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      }
      -    }
      -  }
      -]New value: +[
      +  {
      +    "description": "A template with template_type: html_css. Contains the saved HTML, CSS, and rendering settings. Supply template_values when rendering to substitute placeholder values; update the template to change the saved design.",
      +    "properties": {
      +      "color_scheme": {
      +        "description": "Stored light or dark color-scheme preference exposed to the rendered page's CSS.",
      +        "enum": [
      +          "light",
      +          "dark",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "created_at": {
      +        "description": "UTC timestamp when this template version was created.",
      +        "format": "date-time",
      +        "type": "string"
      +      },
      +      "css": {
      +        "description": "Saved CSS used to style the template. Handlebars substitutions are evaluated in html, so place dynamic style values there.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "description": {
      +        "description": "Optional notes about the template's purpose and intended use.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "device_scale": {
      +        "description": "Stored screenshot pixel ratio. For example, 2 produces two output pixels per CSS pixel in each dimension. Null uses the rendering default.",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "disable_twemoji": {
      +        "description": "Whether native emoji rendering is used instead of Twemoji. Null leaves the rendering default in effect.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "google_fonts": {
      +        "description": "Google Font families loaded for this template, separated by |. The HTML or CSS must reference the families to use them.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "html": {
      +        "description": "Saved HTML source, including any Handlebars placeholders such as {{title}}. Pass matching values without braces, such as a title property in template_values, when rendering.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "id": {
      +        "description": "Unique template identifier used when rendering or updating this template.",
      +        "type": "string"
      +      },
      +      "jumbo_max_height": {
      +        "description": "Stored maximum output height in pixels for jumbo rendering. Used with jumbo_max_width; jumbo rendering consumes additional image credits.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "jumbo_max_width": {
      +        "description": "Stored maximum output width in pixels for jumbo rendering. Used with jumbo_max_height.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "max_wait_ms": {
      +        "description": "Stored loading-wait limit in milliseconds before capture.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "media_type": {
      +        "description": "Stored CSS media mode: print or screen.",
      +        "enum": [
      +          "print",
      +          "screen",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "ms_delay": {
      +        "description": "Stored additional delay in milliseconds before capture, used to allow client-side content to finish updating.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "name": {
      +        "description": "Optional display name for template discovery. Use id to identify the template in rendering and update requests.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "proxy_id": {
      +        "description": "Identifier of the configured organization proxy used for rendering. Proxy connection details are available through the proxy configuration.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "render_count": {
      +        "description": "Number of image creations recorded for this template version. Organization-wide image-credit usage is reported separately.",
      +        "type": "integer"
      +      },
      +      "render_when_ready": {
      +        "description": "Whether capture waits for the template's JavaScript to call ScreenshotReady(). When enabled, rendering fails if the readiness signal is never sent.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "request_overrides": {
      +        "description": "Stored browser request overrides. Block rules match URL wildcard patterns and/or resource types; supplied matchers must all match. Null or an empty array adds no overrides.",
      +        "items": {
      +          "anyOf": [
      +            {
      +              "properties": {
      +                "action": {
      +                  "const": "block"
      +                },
      +                "resource_types": {
      +                  "description": "Resource types to match, supplied as an array of names, such as image, script, xhr, or fetch. Any listed type may match. When url is also supplied, it must match too.",
      +                  "items": {
      +                    "enum": [
      +                      "beacon",
      +                      "document",
      +                      "stylesheet",
      +                      "image",
      +                      "image_set",
      +                      "media",
      +                      "font",
      +                      "script",
      +                      "text_track",
      +                      "xhr",
      +                      "fetch",
      +                      "event_source",
      +                      "manifest",
      +                      "ping",
      +                      "img",
      +                      "other"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "type": [
      +                    "array",
      +                    "null"
      +                  ]
      +                },
      +                "url": {
      +                  "description": "URL wildcard pattern to match, using * for any sequence of characters. When resource_types is also supplied, both matchers must match.",
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                }
      +              }
      +            }
      +          ],
      +          "description": "A browser request override. The action discriminator selects the rule type; currently only block is supported.",
      +          "required": [
      +            "action"
      +          ],
      +          "type": "object"
      +        },
      +        "type": [
      +          "array",
      +          "null"
      +        ]
      +      },
      +      "selector": {
      +        "description": "CSS selector used to crop rendered images to an element. Preserve this setting when updating the template unless the intended crop changes.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "storage_destination_id": {
      +        "description": "Identifier of the configured destination for rendered files. The destination configuration specifies its provider, enabled state, and storage behavior.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "template_type": {
      +        "const": "html_css"
      +      },
      +      "timezone": {
      +        "description": "Stored IANA timezone identifier exposed to the rendered page, such as America/New_York or UTC.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "transparent_background": {
      +        "description": "Whether the browser's default background is transparent. Backgrounds explicitly painted by the template's HTML or CSS still apply.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "updated_at": {
      +        "description": "UTC timestamp when this template version was last updated.",
      +        "format": "date-time",
      +        "type": "string"
      +      },
      +      "version": {
      +        "description": "Saved template version identifier. Specify it when rendering to select this exact version.",
      +        "type": "integer"
      +      },
      +      "viewport_height": {
      +        "description": "Stored browser viewport height in CSS pixels. Used with viewport_width; setting both disables automatic cropping.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "viewport_landscape": {
      +        "description": "Whether the emulated viewport uses landscape orientation.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "viewport_mobile": {
      +        "description": "Whether mobile viewport emulation is enabled, including support for the page's meta viewport tag.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "viewport_touch": {
      +        "description": "Whether touch support is exposed to the rendered page.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "viewport_width": {
      +        "description": "Stored browser viewport width in CSS pixels. Used with viewport_height; output pixel dimensions also depend on device_scale.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      }
      +    }
      +  },
      +  {
      +    "description": "A template with template_type: blocks, authored in the visual template editor. Contains block counts and variable requirements for rendering. Edit the block design in the template editor.",
      +    "properties": {
      +      "block_counts": {
      +        "additionalProperties": {
      +          "type": "integer"
      +        },
      +        "description": "Number of blocks of each type in the saved design, keyed by block type name. This summarizes the design rather than exposing its editable block tree.",
      +        "type": "object"
      +      },
      +      "color_scheme": {
      +        "description": "Stored light or dark color-scheme preference exposed to the rendered page's CSS.",
      +        "enum": [
      +          "light",
      +          "dark",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "created_at": {
      +        "description": "UTC timestamp when this template version was created.",
      +        "format": "date-time",
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "Optional notes about the template's purpose and intended use.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "device_scale": {
      +        "description": "Stored screenshot pixel ratio. For example, 2 produces two output pixels per CSS pixel in each dimension. Null uses the rendering default.",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "disable_twemoji": {
      +        "description": "Whether native emoji rendering is used instead of Twemoji. Null leaves the rendering default in effect.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "id": {
      +        "description": "Unique template identifier used when rendering or updating this template.",
      +        "type": "string"
      +      },
      +      "jumbo_max_height": {
      +        "description": "Stored maximum output height in pixels for jumbo rendering. Used with jumbo_max_width; jumbo rendering consumes additional image credits.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "jumbo_max_width": {
      +        "description": "Stored maximum output width in pixels for jumbo rendering. Used with jumbo_max_height.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "max_wait_ms": {
      +        "description": "Stored loading-wait limit in milliseconds before capture.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "media_type": {
      +        "description": "Stored CSS media mode: print or screen.",
      +        "enum": [
      +          "print",
      +          "screen",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "ms_delay": {
      +        "description": "Stored additional delay in milliseconds before capture, used to allow client-side content to finish updating.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "name": {
      +        "description": "Optional display name for template discovery. Use id to identify the template in rendering and update requests.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "proxy_id": {
      +        "description": "Identifier of the configured organization proxy used for rendering. Proxy connection details are available through the proxy configuration.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "render_count": {
      +        "description": "Number of image creations recorded for this template version. Organization-wide image-credit usage is reported separately.",
      +        "type": "integer"
      +      },
      +      "render_when_ready": {
      +        "description": "Whether capture waits for the template's JavaScript to call ScreenshotReady(). When enabled, rendering fails if the readiness signal is never sent.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "request_overrides": {
      +        "description": "Stored browser request overrides. Block rules match URL wildcard patterns and/or resource types; supplied matchers must all match. Null or an empty array adds no overrides.",
      +        "items": {
      +          "$ref": "#/properties/data/items/anyOf/0/properties/request_overrides/items",
      +          "description": "A browser request override. The action discriminator selects the rule type; currently only block is supported."
      +        },
      +        "type": [
      +          "array",
      +          "null"
      +        ]
      +      },
      +      "selector": {
      +        "description": "CSS selector used to crop rendered images to an element. Preserve this setting when updating the template unless the intended crop changes.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "storage_destination_id": {
      +        "description": "Identifier of the configured destination for rendered files. The destination configuration specifies its provider, enabled state, and storage behavior.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "template_type": {
      +        "const": "blocks"
      +      },
      +      "timezone": {
      +        "description": "Stored IANA timezone identifier exposed to the rendered page, such as America/New_York or UTC.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "transparent_background": {
      +        "description": "Whether the browser's default background is transparent. Backgrounds explicitly painted by the template's HTML or CSS still apply.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "updated_at": {
      +        "description": "UTC timestamp when this template version was last updated.",
      +        "format": "date-time",
      +        "type": "string"
      +      },
      +      "variables": {
      +        "description": "Discovered template variables and their value requirements. Use these entries to prepare template_values for a rendering request.",
      +        "items": {
      +          "description": "A variable discovered in a block template, with its key, requirement mode, inferred value kind, and any fallback or helper context.",
      +          "properties": {
      +            "fallback_value": {
      +              "description": "Saved fallback JSON value used when the variable is missing and its mode selects fallback behavior. Preserve its JSON value type when supplying an override."
      +            },
      +            "helper_kind": {
      +              "description": "Handlebars helper context used during value validation, such as if, unless, with, or each. Interpret this together with mode and kind_hint when preparing template_values.",
      +              "enum": [
      +                "UNKNOWN",
      +                "None",
      +                "If",
      +                "Unless",
      +                "With",
      +                "Each"
      +              ],
      +              "type": "string"
      +            },
      +            "key": {
      +              "description": "Variable name or path used in template_values, without Handlebars braces. Preserve its casing and nesting when supplying values.",
      +              "type": "string"
      +            },
      +            "kind_hint": {
      +              "description": "Inferred value kind, such as string, boolean, integer, color, object, or collection. Use it to choose an appropriate JSON value; an unknown kind provides no type guidance.",
      +              "enum": [
      +                "UNKNOWN",
      +                "String",
      +                "Boolean",
      +                "Integer",
      +                "Float",
      +                "Color",
      +                "Size",
      +                "Object",
      +                "Collection"
      +              ],
      +              "type": "string"
      +            },
      +            "mode": {
      +              "description": "Whether the template variable is required, ignored, or has a fallback value.",
      +              "enum": [
      +                "Required",
      +                "Ignore",
      +                "Fallback"
      +              ],
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "version": {
      +        "description": "Saved template version identifier. Specify it when rendering to select this exact version.",
      +        "type": "integer"
      +      },
      +      "viewport_height": {
      +        "description": "Stored browser viewport height in CSS pixels. Used with viewport_width; setting both disables automatic cropping.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "viewport_landscape": {
      +        "description": "Whether the emulated viewport uses landscape orientation.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "viewport_mobile": {
      +        "description": "Whether mobile viewport emulation is enabled, including support for the page's meta viewport tag.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "viewport_touch": {
      +        "description": "Whether touch support is exposed to the rendered page.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "viewport_width": {
      +        "description": "Stored browser viewport width in CSS pixels. Used with viewport_height; output pixel dimensions also depend on device_scale.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      }
      +    }
      +  }
      +]
  2. Changed5 schema fields changed
    • changedInput schema / properties / count / description
      Previous value: -"Number of template versions to return, between 1 and 100"New value: +"Required page size from 1 to 100; use 10 for an initial lookup."
    • changedInput schema / properties / max_version / description
      Previous value: -"Specify the maximum version to retrieve, used for paginating"New value: +"Exclusive version cursor. Omit for the newest versions; for the next page, pass pagination.next_page_start from the previous response unchanged."
    • changedInput schema / properties / template_id / description
      Previous value: -"The id of the template to return versions for"New value: +"Exact template ID returned by create_template or found in list_templates."
    • changedOutput schema / properties / data / items / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "color_scheme": {
      -        "enum": [
      -          "light",
      -          "dark",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "created_at": {
      -        "format": "date-time",
      -        "type": "string"
      -      },
      -      "css": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "description": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "device_scale": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "disable_twemoji": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "google_fonts": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "html": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "jumbo_max_height": {
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "jumbo_max_width": {
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "max_wait_ms": {
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "media_type": {
      -        "enum": [
      -          "print",
      -          "screen",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "ms_delay": {
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "name": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "proxy_id": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "render_count": {
      -        "type": "integer"
      -      },
      -      "render_when_ready": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "storage_destination_id": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "template_type": {
      -        "const": "html_css"
      -      },
      -      "timezone": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "transparent_background": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "updated_at": {
      -        "format": "date-time",
      -        "type": "string"
      -      },
      -      "version": {
      -        "type": "integer"
      -      },
      -      "viewport_height": {
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "viewport_landscape": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "viewport_mobile": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "viewport_touch": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "viewport_width": {
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      }
      -    }
      -  },
      -  {
      -    "properties": {
      -      "block_counts": {
      -        "additionalProperties": {
      -          "type": "integer"
      -        },
      -        "type": "object"
      -      },
      -      "color_scheme": {
      -        "enum": [
      -          "light",
      -          "dark",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "created_at": {
      -        "format": "date-time",
      -        "type": "string"
      -      },
      -      "description": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "device_scale": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "disable_twemoji": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "jumbo_max_height": {
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "jumbo_max_width": {
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "max_wait_ms": {
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "media_type": {
      -        "enum": [
      -          "print",
      -          "screen",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "ms_delay": {
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "name": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "proxy_id": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "render_count": {
      -        "type": "integer"
      -      },
      -      "render_when_ready": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "storage_destination_id": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "template_type": {
      -        "const": "blocks"
      -      },
      -      "timezone": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "transparent_background": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "updated_at": {
      -        "format": "date-time",
      -        "type": "string"
      -      },
      -      "variables": {
      -        "items": {
      -          "properties": {
      -            "fallback_value": {
      -              "description": "The fallback value to use if the template variable is not set and mode is set to 'fallback'."
      -            },
      -            "helper_kind": {
      -              "description": "If this variable is found in a handlebars helper, it will be used to determine the validity of the value provided when creating an image.",
      -              "enum": [
      -                "UNKNOWN",
      -                "None",
      -                "If",
      -                "Unless",
      -                "With",
      -                "Each"
      -              ],
      -              "type": "string"
      -            },
      -            "key": {
      -              "description": "The template key used to assign this variable's value.",
      -              "type": "string"
      -            },
      -            "kind_hint": {
      -              "description": "The inferred kind of the template variable.",
      -              "enum": [
      -                "UNKNOWN",
      -                "String",
      -                "Boolean",
      -                "Integer",
      -                "Float",
      -                "Color",
      -                "Size",
      -                "Object",
      -                "Collection"
      -              ],
      -              "type": "string"
      -            },
      -            "mode": {
      -              "description": "Whether the template variable is required, ignored, or has a fallback value.",
      -              "enum": [
      -                "Required",
      -                "Ignore",
      -                "Fallback"
      -              ],
      -              "type": "string"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "version": {
      -        "type": "integer"
      -      },
      -      "viewport_height": {
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "viewport_landscape": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "viewport_mobile": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "viewport_touch": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "viewport_width": {
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      }
      -    }
      -  }
      -]New value: +[
      +  {
      +    "description": "A template with template_type: html_css. Contains the saved HTML, CSS, and rendering settings. Supply template_values when rendering to substitute placeholder values; update the template to change the saved design.",
      +    "properties": {
      +      "color_scheme": {
      +        "description": "Stored light or dark color-scheme preference exposed to the rendered page's CSS.",
      +        "enum": [
      +          "light",
      +          "dark",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "created_at": {
      +        "description": "UTC timestamp when this template version was created.",
      +        "format": "date-time",
      +        "type": "string"
      +      },
      +      "css": {
      +        "description": "Saved CSS used to style the template. Handlebars substitutions are evaluated in html, so place dynamic style values there.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "description": {
      +        "description": "Optional notes about the template's purpose and intended use.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "device_scale": {
      +        "description": "Stored screenshot pixel ratio. For example, 2 produces two output pixels per CSS pixel in each dimension. Null uses the rendering default.",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "disable_twemoji": {
      +        "description": "Whether native emoji rendering is used instead of Twemoji. Null leaves the rendering default in effect.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "google_fonts": {
      +        "description": "Google Font families loaded for this template, separated by |. The HTML or CSS must reference the families to use them.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "html": {
      +        "description": "Saved HTML source, including any Handlebars placeholders such as {{title}}. Pass matching values without braces, such as a title property in template_values, when rendering.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "id": {
      +        "description": "Unique template identifier used when rendering or updating this template.",
      +        "type": "string"
      +      },
      +      "jumbo_max_height": {
      +        "description": "Stored maximum output height in pixels for jumbo rendering. Used with jumbo_max_width; jumbo rendering consumes additional image credits.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "jumbo_max_width": {
      +        "description": "Stored maximum output width in pixels for jumbo rendering. Used with jumbo_max_height.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "max_wait_ms": {
      +        "description": "Stored loading-wait limit in milliseconds before capture.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "media_type": {
      +        "description": "Stored CSS media mode: print or screen.",
      +        "enum": [
      +          "print",
      +          "screen",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "ms_delay": {
      +        "description": "Stored additional delay in milliseconds before capture, used to allow client-side content to finish updating.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "name": {
      +        "description": "Optional display name for template discovery. Use id to identify the template in rendering and update requests.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "proxy_id": {
      +        "description": "Identifier of the configured organization proxy used for rendering. Proxy connection details are available through the proxy configuration.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "render_count": {
      +        "description": "Number of image creations recorded for this template version. Organization-wide image-credit usage is reported separately.",
      +        "type": "integer"
      +      },
      +      "render_when_ready": {
      +        "description": "Whether capture waits for the template's JavaScript to call ScreenshotReady(). When enabled, rendering fails if the readiness signal is never sent.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "selector": {
      +        "description": "CSS selector used to crop rendered images to an element. Preserve this setting when updating the template unless the intended crop changes.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "storage_destination_id": {
      +        "description": "Identifier of the configured destination for rendered files. The destination configuration specifies its provider, enabled state, and storage behavior.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "template_type": {
      +        "const": "html_css"
      +      },
      +      "timezone": {
      +        "description": "Stored IANA timezone identifier exposed to the rendered page, such as America/New_York or UTC.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "transparent_background": {
      +        "description": "Whether the browser's default background is transparent. Backgrounds explicitly painted by the template's HTML or CSS still apply.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "updated_at": {
      +        "description": "UTC timestamp when this template version was last updated.",
      +        "format": "date-time",
      +        "type": "string"
      +      },
      +      "version": {
      +        "description": "Saved template version identifier. Specify it when rendering to select this exact version.",
      +        "type": "integer"
      +      },
      +      "viewport_height": {
      +        "description": "Stored browser viewport height in CSS pixels. Used with viewport_width; setting both disables automatic cropping.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "viewport_landscape": {
      +        "description": "Whether the emulated viewport uses landscape orientation.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "viewport_mobile": {
      +        "description": "Whether mobile viewport emulation is enabled, including support for the page's meta viewport tag.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "viewport_touch": {
      +        "description": "Whether touch support is exposed to the rendered page.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "viewport_width": {
      +        "description": "Stored browser viewport width in CSS pixels. Used with viewport_height; output pixel dimensions also depend on device_scale.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      }
      +    }
      +  },
      +  {
      +    "description": "A template with template_type: blocks, authored in the visual template editor. Contains block counts and variable requirements for rendering. Edit the block design in the template editor.",
      +    "properties": {
      +      "block_counts": {
      +        "additionalProperties": {
      +          "type": "integer"
      +        },
      +        "description": "Number of blocks of each type in the saved design, keyed by block type name. This summarizes the design rather than exposing its editable block tree.",
      +        "type": "object"
      +      },
      +      "color_scheme": {
      +        "description": "Stored light or dark color-scheme preference exposed to the rendered page's CSS.",
      +        "enum": [
      +          "light",
      +          "dark",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "created_at": {
      +        "description": "UTC timestamp when this template version was created.",
      +        "format": "date-time",
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "Optional notes about the template's purpose and intended use.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "device_scale": {
      +        "description": "Stored screenshot pixel ratio. For example, 2 produces two output pixels per CSS pixel in each dimension. Null uses the rendering default.",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "disable_twemoji": {
      +        "description": "Whether native emoji rendering is used instead of Twemoji. Null leaves the rendering default in effect.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "id": {
      +        "description": "Unique template identifier used when rendering or updating this template.",
      +        "type": "string"
      +      },
      +      "jumbo_max_height": {
      +        "description": "Stored maximum output height in pixels for jumbo rendering. Used with jumbo_max_width; jumbo rendering consumes additional image credits.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "jumbo_max_width": {
      +        "description": "Stored maximum output width in pixels for jumbo rendering. Used with jumbo_max_height.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "max_wait_ms": {
      +        "description": "Stored loading-wait limit in milliseconds before capture.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "media_type": {
      +        "description": "Stored CSS media mode: print or screen.",
      +        "enum": [
      +          "print",
      +          "screen",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "ms_delay": {
      +        "description": "Stored additional delay in milliseconds before capture, used to allow client-side content to finish updating.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "name": {
      +        "description": "Optional display name for template discovery. Use id to identify the template in rendering and update requests.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "proxy_id": {
      +        "description": "Identifier of the configured organization proxy used for rendering. Proxy connection details are available through the proxy configuration.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "render_count": {
      +        "description": "Number of image creations recorded for this template version. Organization-wide image-credit usage is reported separately.",
      +        "type": "integer"
      +      },
      +      "render_when_ready": {
      +        "description": "Whether capture waits for the template's JavaScript to call ScreenshotReady(). When enabled, rendering fails if the readiness signal is never sent.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "selector": {
      +        "description": "CSS selector used to crop rendered images to an element. Preserve this setting when updating the template unless the intended crop changes.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "storage_destination_id": {
      +        "description": "Identifier of the configured destination for rendered files. The destination configuration specifies its provider, enabled state, and storage behavior.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "template_type": {
      +        "const": "blocks"
      +      },
      +      "timezone": {
      +        "description": "Stored IANA timezone identifier exposed to the rendered page, such as America/New_York or UTC.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "transparent_background": {
      +        "description": "Whether the browser's default background is transparent. Backgrounds explicitly painted by the template's HTML or CSS still apply.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "updated_at": {
      +        "description": "UTC timestamp when this template version was last updated.",
      +        "format": "date-time",
      +        "type": "string"
      +      },
      +      "variables": {
      +        "description": "Discovered template variables and their value requirements. Use these entries to prepare template_values for a rendering request.",
      +        "items": {
      +          "description": "A variable discovered in a block template, with its key, requirement mode, inferred value kind, and any fallback or helper context.",
      +          "properties": {
      +            "fallback_value": {
      +              "description": "Saved fallback JSON value used when the variable is missing and its mode selects fallback behavior. Preserve its JSON value type when supplying an override."
      +            },
      +            "helper_kind": {
      +              "description": "Handlebars helper context used during value validation, such as if, unless, with, or each. Interpret this together with mode and kind_hint when preparing template_values.",
      +              "enum": [
      +                "UNKNOWN",
      +                "None",
      +                "If",
      +                "Unless",
      +                "With",
      +                "Each"
      +              ],
      +              "type": "string"
      +            },
      +            "key": {
      +              "description": "Variable name or path used in template_values, without Handlebars braces. Preserve its casing and nesting when supplying values.",
      +              "type": "string"
      +            },
      +            "kind_hint": {
      +              "description": "Inferred value kind, such as string, boolean, integer, color, object, or collection. Use it to choose an appropriate JSON value; an unknown kind provides no type guidance.",
      +              "enum": [
      +                "UNKNOWN",
      +                "String",
      +                "Boolean",
      +                "Integer",
      +                "Float",
      +                "Color",
      +                "Size",
      +                "Object",
      +                "Collection"
      +              ],
      +              "type": "string"
      +            },
      +            "mode": {
      +              "description": "Whether the template variable is required, ignored, or has a fallback value.",
      +              "enum": [
      +                "Required",
      +                "Ignore",
      +                "Fallback"
      +              ],
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "version": {
      +        "description": "Saved template version identifier. Specify it when rendering to select this exact version.",
      +        "type": "integer"
      +      },
      +      "viewport_height": {
      +        "description": "Stored browser viewport height in CSS pixels. Used with viewport_width; setting both disables automatic cropping.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "viewport_landscape": {
      +        "description": "Whether the emulated viewport uses landscape orientation.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "viewport_mobile": {
      +        "description": "Whether mobile viewport emulation is enabled, including support for the page's meta viewport tag.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "viewport_touch": {
      +        "description": "Whether touch support is exposed to the rendered page.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "viewport_width": {
      +        "description": "Stored browser viewport width in CSS pixels. Used with viewport_height; output pixel dimensions also depend on device_scale.",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      }
      +    }
      +  }
      +]
    • addedOutput schema / properties / data / items / description
      Added value: +"A saved image template version. template_type identifies the html_css or blocks variant. Use id as the template identifier and version to render a specific saved version. Nullable rendering settings are stored overrides; null means the setting is unset."
  3. First observed

TDQS

A4.5/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true, destructiveHint=false, and openWorldHint=false, so safety is covered. The description adds meaningful context beyond that: newest-first ordering, the shape of returned data, and the exact cursor-based continuation and termination rules for paging.

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

Conciseness5/5

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

Three tight sentences with zero filler: what it returns and ordering first, then when to use it and the sibling it pairs with, then the pagination rule. Every sentence carries distinct, actionable information.

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

Completeness5/5

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

With an output schema present, return values need not be spelled out, and the description still sketches the data payload. All three parameters are documented in the schema and the description adds the cross-call pagination workflow, so an agent has everything needed to call it repeatedly without looping incorrectly.

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

Parameters4/5

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

Schema coverage is 100% and the schema already documents count, max_version, and template_id. The description still adds value by explaining the pagination protocol end-to-end (feed next_page_start back as max_version unchanged), which goes beyond the per-parameter schema text.

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

Purpose5/5

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

States a precise verb+resource+scope: 'Lists saved versions of one template, newest first, with their content and rendering settings in data.' The 'one template' scoping and ordering clearly distinguishes it from the sibling list_templates, so an agent can pick the right tool without opening either schema.

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

Usage Guidelines4/5

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

Explicitly names use cases and downstream tools: inspect a template before updating it, or pick an older version for create_templated_image. It also gives a complete pagination loop ('pass pagination.next_page_start as max_version; stop when data is empty or the cursor is null'). No explicit when-not guidance (e.g., use list_templates to enumerate templates) keeps it from a 5.

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.