---
title: "Update an image template"
method: PATCH
path: "/image_templates/{uid}"
---

# Update an image template

`PATCH /image_templates/{uid}`

Update any subset of template attributes. Passing `config` fully replaces the template's canvas configuration.

## Path parameters

- `uid` string, required

## Request body

- object
  - `name` string — Template name
  - `description` string, nullable — Template description
  - `tags` string[] — Template tags
  - `width` integer — Canvas width in pixels
  - `height` integer — Canvas height in pixels
  - `config` object — Full canvas configuration. Replaces the existing config in place.
    - `objects` Layer[] — Layers on the canvas
      - union
        - LayerText — A `text` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'text', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `align-items` 'start' | 'center' | 'end' — Vertical text alignment within the container
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `background-color` string — background-color
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `color` string — color
          - `color-secondary` string — Text color for text wrapped in *asterisks*
          - `direction` 'ltr' | 'rtl' — direction
          - `font-family` string — Font family name (Google Fonts or custom font)
          - `font-family-secondary` string — Font family for text wrapped in *asterisks*
          - `font-size` number — font-size
          - `font-style` 'normal' | 'italic' — font-style
          - `font-style-secondary` 'normal' | 'italic', nullable — Font style for text wrapped in *asterisks*
          - `font-weight` 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 — font-weight
          - `font-weight-secondary` 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900, nullable — Font weight for text wrapped in *asterisks*
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `letter-spacing` number — letter-spacing
          - `line-height` number — Line height multiplier for text spacing
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `skewX` number — Horizontal skew angle in degrees
          - `skewY` number — Vertical skew angle in degrees
          - `text` string — Text content to display
          - `text-align` 'left' | 'center' | 'right' | 'justify' | 'start' | 'end' — Horizontal text alignment
          - `text-background-image-mask` string — Image URL to use as a clipping mask for the text fill
          - `text-decoration` 'none' | 'underline' | 'overline' — text-decoration
          - `text-decoration-secondary` 'none' | 'underline' | 'line-through', nullable — Text decoration for text wrapped in *asterisks*
          - `text-ellipsis` boolean — Truncate overflowing text with an ellipsis
          - `text-fit` 'off' | 'auto_fit' | 'resize_overflow' — How text is sized to fit its container
          - `text-highlight-border-radius` number — Corner radius of the text highlight in pixels
          - `text-highlight-color` string — Background color behind individual lines of text
          - `text-highlight-padding-horizontal` number — Horizontal padding around text highlight in pixels
          - `text-highlight-padding-vertical` number — Vertical padding around text highlight in pixels
          - `text-shadow` string — text-shadow
          - `text-stroke-color` string — Color of the text outline stroke
          - `text-stroke-width` number — Width of the text outline stroke in pixels
          - `text-transform` 'none' | 'uppercase' | 'lowercase' | 'capitalize' — text-transform
          - `text-transform-secondary` 'none' | 'uppercase' | 'lowercase' | 'capitalize', nullable — Text transform for text wrapped in *asterisks*
          - `top` number — top
          - `white-space` 'normal' | 'nowrap' | 'pre' | 'pre-wrap' | 'pre-line' — How whitespace and line breaks are handled
          - `width` number — width
          - `word-break` 'normal' | 'break-all' | 'keep-all' | 'break-word' — word-break
        - LayerRectangle — A `rectangle` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'rectangle', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `background-color` string — Background color of the container
          - `background-color-gradient` string — Second color for a two-color gradient fill
          - `background-gradient-direction` 'left' | 'right' | 'top' | 'bottom' — Direction of the gradient fill
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `top` number — top
          - `width` number — width
        - LayerRectangleImageContainer — A `rectangle_image_container` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'rectangle_image_container', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `ai-background-generate` 'disabled' | 'enabled' — Whether the container should generate its background image via AI when an ai-prompt is supplied in the API request
          - `ai-background-remove` 'disabled' | 'enabled' — Whether to automatically remove the background of images submitted to this container via the API
          - `ai-detect` 'off' | 'face' | 'subject' — AI detection mode for automatic image positioning
          - `ai-detect-anchor` string — Manual anchor point override for AI detection in x:y format (0-100)
          - `ai-detect-focus` 'first' | 'largest' | 'group' — Which detection to focus on when multiple are found
          - `ai-detect-on-fail` 'fallback_cover' | 'fallback_contain' — Fallback background-size when no face or subject is detected
          - `ai-detect-zoom` 'auto' | '50%' | '60%' | '70%' | '80%' | '90%' — Zoom level for AI detection crop
          - `ai-prompt` string — Prompt for AI background generation — applies when the layer has ai-background-generate enabled
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `background-blend-mode` 'normal' | 'multiply' | 'screen' | 'overlay' | 'darken' | 'lighten' | 'color-dodge' | 'color-burn' | 'hard-light' | 'soft-light' | 'difference' | 'exclusion' | 'hue' | 'saturation' | 'color' | 'luminosity' — Blend mode applied to the background image
          - `background-color` string — Background color of the container
          - `background-color-gradient` string — Second color for a two-color gradient fill
          - `background-gradient-direction` 'left' | 'right' | 'top' | 'bottom' — Direction of the gradient fill
          - `background-image` string — Image URL to display in the container
          - `background-position` 'center' | 'top' | 'right' | 'bottom' | 'left' | 'top left' | 'top right' | 'bottom left' | 'bottom right' — Anchor position for the background image within the container — most useful when background-size is contain
          - `background-size` 'cover' | 'contain' — background-size
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `brightness` number — Brightness adjustment where 1 is normal
          - `contrast` number — Contrast adjustment where 1 is normal
          - `grayscale` number — Grayscale filter intensity from 0 to 1
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `png-shadow` string — Drop shadow for PNG images in CSS shadow format
          - `png-stroke-color` string — Outline stroke color around PNG images
          - `png-stroke-width` number — Outline stroke width around PNG images in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `saturate` number — Saturation adjustment where 1 is normal
          - `sepia` number — Sepia filter intensity from 0 to 1
          - `top` number — top
          - `width` number — width
        - LayerCircle — A `circle` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'circle', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `aspect-ratio-locked` boolean — aspect-ratio-locked
          - `background-color` string — Background color of the container
          - `background-color-gradient` string — Second color for a two-color gradient fill
          - `background-gradient-direction` 'left' | 'right' | 'top' | 'bottom' — Direction of the gradient fill
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — responsive-aspect-ratio
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `top` number — top
          - `width` number — width
        - LayerCircleImageContainer — A `circle_image_container` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'circle_image_container', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `ai-background-generate` 'disabled' | 'enabled' — Whether the container should generate its background image via AI when an ai-prompt is supplied in the API request
          - `ai-background-remove` 'disabled' | 'enabled' — Whether to automatically remove the background of images submitted to this container via the API
          - `ai-detect` 'off' | 'face' | 'subject' — AI detection mode for automatic image positioning
          - `ai-detect-anchor` string — Manual anchor point override for AI detection in x:y format (0-100)
          - `ai-detect-focus` 'first' | 'largest' | 'group' — Which detection to focus on when multiple are found
          - `ai-detect-on-fail` 'fallback_cover' | 'fallback_contain' — Fallback background-size when no face or subject is detected
          - `ai-detect-zoom` 'auto' | '50%' | '60%' | '70%' | '80%' | '90%' — Zoom level for AI detection crop
          - `ai-prompt` string — Prompt for AI background generation — applies when the layer has ai-background-generate enabled
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `aspect-ratio-locked` boolean — aspect-ratio-locked
          - `background-blend-mode` 'normal' | 'multiply' | 'screen' | 'overlay' | 'darken' | 'lighten' | 'color-dodge' | 'color-burn' | 'hard-light' | 'soft-light' | 'difference' | 'exclusion' | 'hue' | 'saturation' | 'color' | 'luminosity' — Blend mode applied to the background image
          - `background-color` string — Background color of the container
          - `background-color-gradient` string — Second color for a two-color gradient fill
          - `background-gradient-direction` 'left' | 'right' | 'top' | 'bottom' — Direction of the gradient fill
          - `background-image` string — Image URL to display in the container
          - `background-position` 'center' | 'top' | 'right' | 'bottom' | 'left' | 'top left' | 'top right' | 'bottom left' | 'bottom right' — Anchor position for the background image within the container — most useful when background-size is contain
          - `background-size` 'cover' | 'contain' — background-size
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `brightness` number — Brightness adjustment where 1 is normal
          - `contrast` number — Contrast adjustment where 1 is normal
          - `grayscale` number — Grayscale filter intensity from 0 to 1
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `png-shadow` string — Drop shadow for PNG images in CSS shadow format
          - `png-stroke-color` string — Outline stroke color around PNG images
          - `png-stroke-width` number — Outline stroke width around PNG images in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — responsive-aspect-ratio
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `saturate` number — Saturation adjustment where 1 is normal
          - `sepia` number — Sepia filter intensity from 0 to 1
          - `top` number — top
          - `width` number — width
        - LayerImage — A `image` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'image', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `aspect-ratio-locked` boolean — aspect-ratio-locked
          - `background-blend-mode` 'normal' | 'multiply' | 'screen' | 'overlay' | 'darken' | 'lighten' | 'color-dodge' | 'color-burn' | 'hard-light' | 'soft-light' | 'difference' | 'exclusion' | 'hue' | 'saturation' | 'color' | 'luminosity' — Blend mode applied to the image
          - `background-color` string — Background color of the container
          - `background-image` string — Image URL to display
          - `background-size` 'cover' | 'contain' — background-size
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `brightness` number — Brightness adjustment where 1 is normal
          - `contrast` number — Contrast adjustment where 1 is normal
          - `grayscale` number — Grayscale filter intensity from 0 to 1
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `png-shadow` string — Drop shadow for PNG images in CSS shadow format
          - `png-stroke-color` string — Outline stroke color around PNG images
          - `png-stroke-width` number — Outline stroke width around PNG images in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `saturate` number — Saturation adjustment where 1 is normal
          - `sepia` number — Sepia filter intensity from 0 to 1
          - `top` number — top
          - `width` number — width
        - LayerSvgShape — A `svg_shape` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'svg_shape', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `background-color` string — Background color of the container
          - `background-color-gradient` string — Second color for a two-color gradient fill
          - `background-gradient-direction` 'left' | 'right' | 'top' | 'bottom' — Direction of the gradient fill
          - `basic-shape` 'triangle' | 'scalene' | 'pentagon' | 'right' | 'trapeze' | 'kite' | 'polygon' | 'parallelogram' | 'ellipse' | 'trefoil' | 'star' | 'semicircle' | 'hexagon' | 'crescent' | 'octagon' | 'cross' | 'ring' | 'heart' | 'arrow' | 'rhombus' — The SVG shape to render
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `fill` string — Fill color of the shape
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `stroke` string — Stroke color of the shape outline
          - `stroke-width` number — Stroke width of the shape outline in pixels
          - `top` number — top
          - `width` number — width
        - LayerQrCode — A `qr_code` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'qr_code', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `background-color` string — Background color of the container
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `qr-color` string — Foreground color of the QR code
          - `qr-target` string — URL or text content to encode in the QR code
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `top` number — top
          - `width` number — width
        - LayerBarCode — A `bar_code` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'bar_code', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `background-color` string — Background color of the container
          - `barcode-color` string — Foreground color of the barcode
          - `barcode-data` string — Data to encode in the barcode
          - `barcode-format` 'CODE128' | 'EAN13' | 'UPC' | 'EAN8' — Barcode encoding format
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `top` number — top
          - `width` number — width
        - LayerRating — A `rating` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'rating', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `background-color` string — Background color of the container
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `rating-background-color` string — Fill color for inactive rating shapes
          - `rating-color` string — Fill color for active rating shapes
          - `rating-count` number — Number of shapes to display
          - `rating-gap` number — Gap between rating shapes in pixels
          - `rating-score` number — Rating score from 0 to 100
          - `rating-shadow` string — Drop shadow for rating shapes in CSS shadow format
          - `rating-shape` 'star' | 'cute_star' | 'heart' | 'circle' | 'diamond' | 'square' | 'hexagon' — Shape used for each rating unit
          - `rating-stroke-color` string — Outline stroke color for rating shapes
          - `rating-stroke-width` number — Outline stroke width for rating shapes in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `top` number — top
          - `width` number — width
        - LayerLottie — A `lottie` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'lottie', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `aspect-ratio-locked` boolean — aspect-ratio-locked
          - `background-color` string — background-color
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `lottie-delay` number — Milliseconds to wait after the animation starts before this Lottie begins playing
          - `lottie-loop` boolean — Whether the Lottie repeats when it reaches its end, rather than holding its last frame
          - `lottie-url` string — URL of the Lottie JSON file to play
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `top` number — top
          - `width` number — width
        - LayerGroup — A `group` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'group', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `background-color` string — Background color of the container
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `collapsed` boolean — collapsed
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `top` number — top
          - `width` number — width

## Response `200`

Updated template

- object — Image template. `config.objects` is the full canvas config — matches exactly the shape PATCH accepts, so responses round-trip cleanly.
  - `uid` string
  - `name` string
  - `description` string, nullable
  - `tags` string[]
  - `width` integer
  - `height` integer
  - `responsive` boolean — True if the template has responsive sizing or positioning
  - `preview` string, uri, nullable — Preview image URL
  - `ui_write_access` 'owner_only' | 'team' — Who can edit this template in the dashboard — `owner_only` (default) or `team`
  - `api_write_access` 'team' | 'owner_only' | 'nobody' — Who can update or delete this template via the API — `team` (default, any workspace API key), `owner_only` (only API keys owned by the template's creator), or `nobody` (locked; unlock via dashboard)
  - `config` object — Full canvas configuration.
    - `objects` Layer[] — Layers on the canvas
      - union
        - LayerText — A `text` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'text', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `align-items` 'start' | 'center' | 'end' — Vertical text alignment within the container
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `background-color` string — background-color
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `color` string — color
          - `color-secondary` string — Text color for text wrapped in *asterisks*
          - `direction` 'ltr' | 'rtl' — direction
          - `font-family` string — Font family name (Google Fonts or custom font)
          - `font-family-secondary` string — Font family for text wrapped in *asterisks*
          - `font-size` number — font-size
          - `font-style` 'normal' | 'italic' — font-style
          - `font-style-secondary` 'normal' | 'italic', nullable — Font style for text wrapped in *asterisks*
          - `font-weight` 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 — font-weight
          - `font-weight-secondary` 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900, nullable — Font weight for text wrapped in *asterisks*
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `letter-spacing` number — letter-spacing
          - `line-height` number — Line height multiplier for text spacing
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `skewX` number — Horizontal skew angle in degrees
          - `skewY` number — Vertical skew angle in degrees
          - `text` string — Text content to display
          - `text-align` 'left' | 'center' | 'right' | 'justify' | 'start' | 'end' — Horizontal text alignment
          - `text-background-image-mask` string — Image URL to use as a clipping mask for the text fill
          - `text-decoration` 'none' | 'underline' | 'overline' — text-decoration
          - `text-decoration-secondary` 'none' | 'underline' | 'line-through', nullable — Text decoration for text wrapped in *asterisks*
          - `text-ellipsis` boolean — Truncate overflowing text with an ellipsis
          - `text-fit` 'off' | 'auto_fit' | 'resize_overflow' — How text is sized to fit its container
          - `text-highlight-border-radius` number — Corner radius of the text highlight in pixels
          - `text-highlight-color` string — Background color behind individual lines of text
          - `text-highlight-padding-horizontal` number — Horizontal padding around text highlight in pixels
          - `text-highlight-padding-vertical` number — Vertical padding around text highlight in pixels
          - `text-shadow` string — text-shadow
          - `text-stroke-color` string — Color of the text outline stroke
          - `text-stroke-width` number — Width of the text outline stroke in pixels
          - `text-transform` 'none' | 'uppercase' | 'lowercase' | 'capitalize' — text-transform
          - `text-transform-secondary` 'none' | 'uppercase' | 'lowercase' | 'capitalize', nullable — Text transform for text wrapped in *asterisks*
          - `top` number — top
          - `white-space` 'normal' | 'nowrap' | 'pre' | 'pre-wrap' | 'pre-line' — How whitespace and line breaks are handled
          - `width` number — width
          - `word-break` 'normal' | 'break-all' | 'keep-all' | 'break-word' — word-break
        - LayerRectangle — A `rectangle` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'rectangle', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `background-color` string — Background color of the container
          - `background-color-gradient` string — Second color for a two-color gradient fill
          - `background-gradient-direction` 'left' | 'right' | 'top' | 'bottom' — Direction of the gradient fill
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `top` number — top
          - `width` number — width
        - LayerRectangleImageContainer — A `rectangle_image_container` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'rectangle_image_container', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `ai-background-generate` 'disabled' | 'enabled' — Whether the container should generate its background image via AI when an ai-prompt is supplied in the API request
          - `ai-background-remove` 'disabled' | 'enabled' — Whether to automatically remove the background of images submitted to this container via the API
          - `ai-detect` 'off' | 'face' | 'subject' — AI detection mode for automatic image positioning
          - `ai-detect-anchor` string — Manual anchor point override for AI detection in x:y format (0-100)
          - `ai-detect-focus` 'first' | 'largest' | 'group' — Which detection to focus on when multiple are found
          - `ai-detect-on-fail` 'fallback_cover' | 'fallback_contain' — Fallback background-size when no face or subject is detected
          - `ai-detect-zoom` 'auto' | '50%' | '60%' | '70%' | '80%' | '90%' — Zoom level for AI detection crop
          - `ai-prompt` string — Prompt for AI background generation — applies when the layer has ai-background-generate enabled
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `background-blend-mode` 'normal' | 'multiply' | 'screen' | 'overlay' | 'darken' | 'lighten' | 'color-dodge' | 'color-burn' | 'hard-light' | 'soft-light' | 'difference' | 'exclusion' | 'hue' | 'saturation' | 'color' | 'luminosity' — Blend mode applied to the background image
          - `background-color` string — Background color of the container
          - `background-color-gradient` string — Second color for a two-color gradient fill
          - `background-gradient-direction` 'left' | 'right' | 'top' | 'bottom' — Direction of the gradient fill
          - `background-image` string — Image URL to display in the container
          - `background-position` 'center' | 'top' | 'right' | 'bottom' | 'left' | 'top left' | 'top right' | 'bottom left' | 'bottom right' — Anchor position for the background image within the container — most useful when background-size is contain
          - `background-size` 'cover' | 'contain' — background-size
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `brightness` number — Brightness adjustment where 1 is normal
          - `contrast` number — Contrast adjustment where 1 is normal
          - `grayscale` number — Grayscale filter intensity from 0 to 1
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `png-shadow` string — Drop shadow for PNG images in CSS shadow format
          - `png-stroke-color` string — Outline stroke color around PNG images
          - `png-stroke-width` number — Outline stroke width around PNG images in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `saturate` number — Saturation adjustment where 1 is normal
          - `sepia` number — Sepia filter intensity from 0 to 1
          - `top` number — top
          - `width` number — width
        - LayerCircle — A `circle` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'circle', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `aspect-ratio-locked` boolean — aspect-ratio-locked
          - `background-color` string — Background color of the container
          - `background-color-gradient` string — Second color for a two-color gradient fill
          - `background-gradient-direction` 'left' | 'right' | 'top' | 'bottom' — Direction of the gradient fill
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — responsive-aspect-ratio
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `top` number — top
          - `width` number — width
        - LayerCircleImageContainer — A `circle_image_container` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'circle_image_container', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `ai-background-generate` 'disabled' | 'enabled' — Whether the container should generate its background image via AI when an ai-prompt is supplied in the API request
          - `ai-background-remove` 'disabled' | 'enabled' — Whether to automatically remove the background of images submitted to this container via the API
          - `ai-detect` 'off' | 'face' | 'subject' — AI detection mode for automatic image positioning
          - `ai-detect-anchor` string — Manual anchor point override for AI detection in x:y format (0-100)
          - `ai-detect-focus` 'first' | 'largest' | 'group' — Which detection to focus on when multiple are found
          - `ai-detect-on-fail` 'fallback_cover' | 'fallback_contain' — Fallback background-size when no face or subject is detected
          - `ai-detect-zoom` 'auto' | '50%' | '60%' | '70%' | '80%' | '90%' — Zoom level for AI detection crop
          - `ai-prompt` string — Prompt for AI background generation — applies when the layer has ai-background-generate enabled
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `aspect-ratio-locked` boolean — aspect-ratio-locked
          - `background-blend-mode` 'normal' | 'multiply' | 'screen' | 'overlay' | 'darken' | 'lighten' | 'color-dodge' | 'color-burn' | 'hard-light' | 'soft-light' | 'difference' | 'exclusion' | 'hue' | 'saturation' | 'color' | 'luminosity' — Blend mode applied to the background image
          - `background-color` string — Background color of the container
          - `background-color-gradient` string — Second color for a two-color gradient fill
          - `background-gradient-direction` 'left' | 'right' | 'top' | 'bottom' — Direction of the gradient fill
          - `background-image` string — Image URL to display in the container
          - `background-position` 'center' | 'top' | 'right' | 'bottom' | 'left' | 'top left' | 'top right' | 'bottom left' | 'bottom right' — Anchor position for the background image within the container — most useful when background-size is contain
          - `background-size` 'cover' | 'contain' — background-size
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `brightness` number — Brightness adjustment where 1 is normal
          - `contrast` number — Contrast adjustment where 1 is normal
          - `grayscale` number — Grayscale filter intensity from 0 to 1
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `png-shadow` string — Drop shadow for PNG images in CSS shadow format
          - `png-stroke-color` string — Outline stroke color around PNG images
          - `png-stroke-width` number — Outline stroke width around PNG images in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — responsive-aspect-ratio
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `saturate` number — Saturation adjustment where 1 is normal
          - `sepia` number — Sepia filter intensity from 0 to 1
          - `top` number — top
          - `width` number — width
        - LayerImage — A `image` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'image', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `aspect-ratio-locked` boolean — aspect-ratio-locked
          - `background-blend-mode` 'normal' | 'multiply' | 'screen' | 'overlay' | 'darken' | 'lighten' | 'color-dodge' | 'color-burn' | 'hard-light' | 'soft-light' | 'difference' | 'exclusion' | 'hue' | 'saturation' | 'color' | 'luminosity' — Blend mode applied to the image
          - `background-color` string — Background color of the container
          - `background-image` string — Image URL to display
          - `background-size` 'cover' | 'contain' — background-size
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `brightness` number — Brightness adjustment where 1 is normal
          - `contrast` number — Contrast adjustment where 1 is normal
          - `grayscale` number — Grayscale filter intensity from 0 to 1
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `png-shadow` string — Drop shadow for PNG images in CSS shadow format
          - `png-stroke-color` string — Outline stroke color around PNG images
          - `png-stroke-width` number — Outline stroke width around PNG images in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `saturate` number — Saturation adjustment where 1 is normal
          - `sepia` number — Sepia filter intensity from 0 to 1
          - `top` number — top
          - `width` number — width
        - LayerSvgShape — A `svg_shape` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'svg_shape', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `background-color` string — Background color of the container
          - `background-color-gradient` string — Second color for a two-color gradient fill
          - `background-gradient-direction` 'left' | 'right' | 'top' | 'bottom' — Direction of the gradient fill
          - `basic-shape` 'triangle' | 'scalene' | 'pentagon' | 'right' | 'trapeze' | 'kite' | 'polygon' | 'parallelogram' | 'ellipse' | 'trefoil' | 'star' | 'semicircle' | 'hexagon' | 'crescent' | 'octagon' | 'cross' | 'ring' | 'heart' | 'arrow' | 'rhombus' — The SVG shape to render
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `fill` string — Fill color of the shape
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `stroke` string — Stroke color of the shape outline
          - `stroke-width` number — Stroke width of the shape outline in pixels
          - `top` number — top
          - `width` number — width
        - LayerQrCode — A `qr_code` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'qr_code', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `background-color` string — Background color of the container
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `qr-color` string — Foreground color of the QR code
          - `qr-target` string — URL or text content to encode in the QR code
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `top` number — top
          - `width` number — width
        - LayerBarCode — A `bar_code` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'bar_code', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `background-color` string — Background color of the container
          - `barcode-color` string — Foreground color of the barcode
          - `barcode-data` string — Data to encode in the barcode
          - `barcode-format` 'CODE128' | 'EAN13' | 'UPC' | 'EAN8' — Barcode encoding format
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `top` number — top
          - `width` number — width
        - LayerRating — A `rating` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'rating', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `background-color` string — Background color of the container
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `rating-background-color` string — Fill color for inactive rating shapes
          - `rating-color` string — Fill color for active rating shapes
          - `rating-count` number — Number of shapes to display
          - `rating-gap` number — Gap between rating shapes in pixels
          - `rating-score` number — Rating score from 0 to 100
          - `rating-shadow` string — Drop shadow for rating shapes in CSS shadow format
          - `rating-shape` 'star' | 'cute_star' | 'heart' | 'circle' | 'diamond' | 'square' | 'hexagon' — Shape used for each rating unit
          - `rating-stroke-color` string — Outline stroke color for rating shapes
          - `rating-stroke-width` number — Outline stroke width for rating shapes in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `top` number — top
          - `width` number — width
        - LayerLottie — A `lottie` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'lottie', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `aspect-ratio-locked` boolean — aspect-ratio-locked
          - `background-color` string — background-color
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `lottie-delay` number — Milliseconds to wait after the animation starts before this Lottie begins playing
          - `lottie-loop` boolean — Whether the Lottie repeats when it reaches its end, rather than holding its last frame
          - `lottie-url` string — URL of the Lottie JSON file to play
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `top` number — top
          - `width` number — width
        - LayerGroup — A `group` layer.
          - `id` string, required — Unique layer id within the config
          - `type` 'group', required — Layer type discriminator
          - `name` string — Optional human-readable layer name
          - `anchor-gap-x` number — Horizontal offset from the anchor point in pixels
          - `anchor-gap-y` number — Vertical offset from the anchor point in pixels
          - `anchor-point` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' — Which point on the target layer to anchor to
          - `anchor-to` string — Name of another layer to anchor this layer's position to
          - `anchor-type` 'container' | 'text' — Whether to anchor to the container bounds or text bounds
          - `background-color` string — Background color of the container
          - `blur` number — Gaussian blur radius in pixels
          - `border-color` string — border-color
          - `border-radius` number — Border radius in pixels for rounded corners
          - `border-style` 'none' | 'solid' — border-style
          - `border-width` number — border-width
          - `box-shadow` string — box-shadow
          - `collapsed` boolean — collapsed
          - `height` number — height
          - `hidden` boolean — Hide or show this layer
          - `left` number — left
          - `opacity` number — Opacity from 0 (transparent) to 1 (opaque)
          - `padding` number — padding
          - `perspective` number — Perspective distance for 3D transforms in pixels
          - `responsive-anchor-gap` 'none' | 'scale' | 'scale-x' | 'scale-y' | 'stretch' | 'stretch-x' | 'stretch-y' — How the anchor gap adjusts when the template is resized
          - `responsive-aspect-ratio` 'free' | 'locked' — Whether the layer keeps its aspect ratio when responsively resized
          - `responsive-position` 'none' | 'scale' | 'center-x' | 'center-y' | 'center' | 'pin-right' | 'pin-bottom' | 'pin-right-bottom' — How the layer repositions when the template is resized
          - `responsive-size` 'none' | 'scale' | 'stretch-x' | 'stretch-y' | 'stretch' — How the layer resizes when the template is resized
          - `rotate` number — Rotation angle in degrees
          - `rotateX` number — 3D rotation around the X axis in degrees
          - `rotateY` number — 3D rotation around the Y axis in degrees
          - `rotateZ` number — 3D rotation around the Z axis in degrees
          - `top` number — top
          - `width` number — width
  - `created_at` string, date-time

## Other responses

- `400` — No editable attributes provided
- `403` — Template's api_write_access is `owner_only` and the caller's API key is not owned by the template's creator
- `404` — Template not found in this workspace
- `422` — Validation failure — e.g. width/height must be between 100 and 3000
- `423` — Template's api_write_access is `nobody` — the owner must unlock it via the dashboard

---

[API](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api.md) · [All operations](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bannerbear/bannerbear-v5-api/revisions/6aa425420a10/schema)