HTML/CSS to Image API

Update a Template

update_template

Destructive

Updates an existing HTML/CSS image template. Replaces its latest version when that version has not been rendered; otherwise creates a new version. Returns item.template_id and item.template_version. Call create_templated_image with the returned ID and version to render the updated design. Use list_template_versions to inspect existing content before replacing it.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`content`	Yes	Complete replacement content for the template. Preserve intentional variable names and render dimensions unless the user requests a change.
`template_id`	Yes	The exact template ID to update.

Output Schema

TableJSON Schema

Name	Required	Description
`item`	No	Operation result. Check success before using this value.
`error`	No	Error details when the operation failed; null on success.
`success`	No	Whether the operation succeeded. If false, inspect error before retrying.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 15, 2026

addedInput schema / properties / content / properties / pdf_options

Added value: +{
+  "description": "Options used when generating a PDF instead of an image. Page dimensions and margins must include supported PDF units; margins must contain either zero or four values; scale must be between 0.1 and 2.",
+  "properties": {
+    "margins": {
+      "description": "Margins of the webpage rendering. Defaults to 0. 4 values must be supplied: top, right, bottom, left. Units are px, cm, in, mm, or pt.",
+      "items": {
+        "type": "string"
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "page_height": {
+      "description": "Height of the page, with unit (px, in, cm, mm, pt)",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "page_width": {
+      "description": "Width of the page, with unit (px, in, cm, mm, pt)",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "print_background": {
+      "description": "Print background graphics.",
+      "type": "boolean"
+    },
+    "scale": {
+      "description": "Scale of the webpage rendering. Defaults to 1.",
+      "maximum": 2,
+      "minimum": 0.1,
+      "type": [
+        "number",
+        "null"
+      ]
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

Changed1 schema field changedSep 29, 2026

addedInput schema / properties / content / properties / request_overrides

Added value: +{
+  "description": "An array of request rules. Use `action: \"block\"` with a `url` wildcard pattern (using `*`) and/or `resource_types` as an array of resource names, such as `image`, `script`, or `xhr`. Both matchers must match when supplied together; any matching block rule blocks the request. Omitted, `null`, or `[]` adds no overrides. Requires a paid plan. Accepts a JSON array in JSON requests or a JSON-encoded array string in form requests. Maximum 100 rules and 512 characters per URL pattern. Each block rule requires a nonempty URL pattern or at least one resource type; supplied matchers cannot be empty.",
+  "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"
+  ]
+}

Changed1 schema field changedSep 22, 2026

changedInput schema / properties / content / properties / disable_twemoji / description

Previous value: -"Use native Linux emoji rendering instead of HCTI's consistent Twemoji images. Leave `disable_twemoji` unset unless native emoji rendering is specifically needed."New value: +"Twemoji is enabled by default for images rendered from the template. Set `disable_twemoji: true` to disable automatic emoji replacement. Omitted, `null`, or `false` keeps Twemoji enabled."

Changed4 schema fields changedSep 15, 2026

addedInput schema / properties / content / properties / selector

Added value: +{
+  "description": "Crop the image to the element matching this CSS selector. Prefer a unique, stable ID such as `#card` when possible.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / error / description

Added value: +"Error details when the operation failed; null on success."

addedOutput schema / properties / item / description

Added value: +"Operation result. Check success before using this value."

addedOutput schema / properties / success / description

Added value: +"Whether the operation succeeded. If false, inspect error before retrying."

First observedSep 15, 2026

TDQS

Score is being calculated.

All HTML/CSS to Image API tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.