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

# Changes to Update an image template

`PATCH /image_templates/{uid}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 14 revisions.

- **2026-09-24** `745da36239a3`: 28 warning, 28 info
- **2026-09-23** `37156820eb24`: 1 warning, 3 info
- **2026-09-21** `708a5945d283`: 5 breaking, 4 warning, 81 info
- **2026-09-18** `b62a85244712`: 1 breaking, 3 info
- **2026-09-09** `c439420dbe16`: 2 info
- **2026-09-09** `b98735eaab44`: 4 info
- **2026-09-01** `6aa425420a10`: 2 warning, 12 info

## Changes

- **2026-09-24** `745da36239a3`: 28 warning, 28 info
  - added the new `center-x-pin-bottom` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerAnimatedBackground]/responsive-position` response property for the response status `200`
  - added the new `center-x-pin-bottom` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerAudioWave]/responsive-position` response property for the response status `200`
  - added the new `center-x-pin-bottom` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerBarCode]/responsive-position` response property for the response status `200`
  - added the new `center-x-pin-bottom` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerCircleImageContainer]/responsive-position` response property for the response status `200`
  - added the new `center-x-pin-bottom` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerCircle]/responsive-position` response property for the response status `200`
  - added the new `center-x-pin-bottom` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerGroup]/responsive-position` response property for the response status `200`
  - added the new `center-x-pin-bottom` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerImage]/responsive-position` response property for the response status `200`
  - added the new `center-x-pin-bottom` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerLottie]/responsive-position` response property for the response status `200`
  - added the new `center-x-pin-bottom` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerQrCode]/responsive-position` response property for the response status `200`
  - added the new `center-x-pin-bottom` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerRating]/responsive-position` response property for the response status `200`
  - added the new `center-x-pin-bottom` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerRectangleImageContainer]/responsive-position` response property for the response status `200`
  - added the new `center-x-pin-bottom` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerRectangle]/responsive-position` response property for the response status `200`
  - added the new `center-x-pin-bottom` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerSvgShape]/responsive-position` response property for the response status `200`
  - added the new `center-x-pin-bottom` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerText]/responsive-position` response property for the response status `200`
  - added the new `center-y-pin-right` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerAnimatedBackground]/responsive-position` response property for the response status `200`
  - added the new `center-y-pin-right` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerAudioWave]/responsive-position` response property for the response status `200`
  - added the new `center-y-pin-right` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerBarCode]/responsive-position` response property for the response status `200`
  - added the new `center-y-pin-right` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerCircleImageContainer]/responsive-position` response property for the response status `200`
  - added the new `center-y-pin-right` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerCircle]/responsive-position` response property for the response status `200`
  - added the new `center-y-pin-right` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerGroup]/responsive-position` response property for the response status `200`
  - added the new `center-y-pin-right` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerImage]/responsive-position` response property for the response status `200`
  - added the new `center-y-pin-right` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerLottie]/responsive-position` response property for the response status `200`
  - added the new `center-y-pin-right` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerQrCode]/responsive-position` response property for the response status `200`
  - added the new `center-y-pin-right` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerRating]/responsive-position` response property for the response status `200`
  - added the new `center-y-pin-right` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerRectangleImageContainer]/responsive-position` response property for the response status `200`
  - added the new `center-y-pin-right` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerRectangle]/responsive-position` response property for the response status `200`
  - added the new `center-y-pin-right` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerSvgShape]/responsive-position` response property for the response status `200`
  - added the new `center-y-pin-right` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerText]/responsive-position` response property for the response status `200`
  - added the new `center-x-pin-bottom` enum value to the request property `config/objects/items/oneOf[#/components/schemas/LayerAnimatedBackground]/responsive-position`
  - added the new `center-x-pin-bottom` enum value to the request property `config/objects/items/oneOf[#/components/schemas/LayerAudioWave]/responsive-position`
  - added the new `center-x-pin-bottom` enum value to the request property `config/objects/items/oneOf[#/components/schemas/LayerBarCode]/responsive-position`
  - added the new `center-x-pin-bottom` enum value to the request property `config/objects/items/oneOf[#/components/schemas/LayerCircleImageContainer]/responsive-position`
  - added the new `center-x-pin-bottom` enum value to the request property `config/objects/items/oneOf[#/components/schemas/LayerCircle]/responsive-position`
  - added the new `center-x-pin-bottom` enum value to the request property `config/objects/items/oneOf[#/components/schemas/LayerGroup]/responsive-position`
  - added the new `center-x-pin-bottom` enum value to the request property `config/objects/items/oneOf[#/components/schemas/LayerImage]/responsive-position`
  - added the new `center-x-pin-bottom` enum value to the request property `config/objects/items/oneOf[#/components/schemas/LayerLottie]/responsive-position`
  - added the new `center-x-pin-bottom` enum value to the request property `config/objects/items/oneOf[#/components/schemas/LayerQrCode]/responsive-position`
  - added the new `center-x-pin-bottom` enum value to the request property `config/objects/items/oneOf[#/components/schemas/LayerRating]/responsive-position`
  - added the new `center-x-pin-bottom` enum value to the request property `config/objects/items/oneOf[#/components/schemas/LayerRectangleImageContainer]/responsive-position`
  - added the new `center-x-pin-bottom` enum value to the request property `config/objects/items/oneOf[#/components/schemas/LayerRectangle]/responsive-position`
  - …16 more
- **2026-09-23** `37156820eb24`: 1 warning, 3 info
  - added the new `custom` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerSvgShape]/basic-shape` response property for the response status `200`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerSvgShape]/svg-url`
  - added the new `custom` enum value to the request property `config/objects/items/oneOf[#/components/schemas/LayerSvgShape]/basic-shape`
  - added the optional property `config/objects/items/oneOf[#/components/schemas/LayerSvgShape]/svg-url` to the response with the `200` status
- **2026-09-21** `708a5945d283`: 5 breaking, 4 warning, 81 info
  - removed the enum value `aurora, Aurora` of the request property `config/objects/items/oneOf[#/components/schemas/LayerAnimatedBackground]/motion-preset`
  - removed the enum value `conic, Conic spin` of the request property `config/objects/items/oneOf[#/components/schemas/LayerAnimatedBackground]/motion-preset`
  - removed the enum value `mesh, Mesh` of the request property `config/objects/items/oneOf[#/components/schemas/LayerAnimatedBackground]/motion-preset`
  - removed the enum value `pulse, Pulse` of the request property `config/objects/items/oneOf[#/components/schemas/LayerAnimatedBackground]/motion-preset`
  - added `#/components/schemas/LayerAudioWave` to the `config/objects/items/` response property `oneOf` list for the response status `200`
  - added the new `aurora` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerAnimatedBackground]/motion-preset` response property for the response status `200`
  - added the new `conic` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerAnimatedBackground]/motion-preset` response property for the response status `200`
  - added the new `mesh` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerAnimatedBackground]/motion-preset` response property for the response status `200`
  - added the new `pulse` enum value to the `config/objects/items/oneOf[#/components/schemas/LayerAnimatedBackground]/motion-preset` response property for the response status `200`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerAnimatedBackground]/clip-mode`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerAnimatedBackground]/clip-to`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerAnimatedBackground]/motion-color`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerBarCode]/clip-mode`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerBarCode]/clip-to`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerCircleImageContainer]/background-crop`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerCircleImageContainer]/background-gradient`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerCircleImageContainer]/clip-mode`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerCircleImageContainer]/clip-to`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerCircle]/background-gradient`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerCircle]/clip-mode`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerCircle]/clip-to`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerGroup]/clip-mode`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerGroup]/clip-to`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerImage]/background-crop`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerImage]/clip-mode`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerImage]/clip-to`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerLottie]/clip-mode`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerLottie]/clip-to`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerQrCode]/clip-mode`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerQrCode]/clip-to`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerRating]/clip-mode`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerRating]/clip-to`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerRectangleImageContainer]/background-crop`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerRectangleImageContainer]/background-gradient`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerRectangleImageContainer]/clip-mode`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerRectangleImageContainer]/clip-to`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerRectangle]/background-gradient`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerRectangle]/clip-mode`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerRectangle]/clip-to`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerSvgShape]/background-gradient`
  - …50 more
- **2026-09-18** `b62a85244712`: 1 breaking, 3 info
  - added `#/components/schemas/LayerAnimatedBackground` to the `config/objects/items/` response property `oneOf` list for the response status `200`
  - added `animated_background` discriminator mapping keys to the `config/objects/items/` request property
  - added `#/components/schemas/LayerAnimatedBackground` to the `config/objects/items/` request property `oneOf` list
  - added `animated_background` discriminator mapping keys to the `config/objects/items/` response property for the response status `200`
- **2026-09-09** `c439420dbe16`: 2 info
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerText]/text-highlight-shadow`
  - added the optional property `config/objects/items/oneOf[#/components/schemas/LayerText]/text-highlight-shadow` to the response with the `200` status
- **2026-09-09** `b98735eaab44`: 4 info
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerCircleImageContainer]/ai-model`
  - added the new optional request property `config/objects/items/oneOf[#/components/schemas/LayerRectangleImageContainer]/ai-model`
  - added the optional property `config/objects/items/oneOf[#/components/schemas/LayerCircleImageContainer]/ai-model` to the response with the `200` status
  - added the optional property `config/objects/items/oneOf[#/components/schemas/LayerRectangleImageContainer]/ai-model` to the response with the `200` status
- **2026-09-01** `6aa425420a10`: 2 warning, 12 info
  - removed the optional property `adaptive` from the response with the `200` status
  - removed the optional property `objects` from the response with the `200` status
  - added the new optional request property `config`
  - added the new optional request property `height`
  - added the new optional request property `width`
  - added the non-success response with the status `400`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `422`
  - added the non-success response with the status `423`
  - added the optional property `api_write_access` to the response with the `200` status
  - added the optional property `config` to the response with the `200` status
  - added the optional property `responsive` to the response with the `200` status
  - added the optional property `ui_write_access` to the response with the `200` status

---

[Operation](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api/docs/image_templates/:uid/patch.md) - [API](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api.md) - [Page](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api/changes/image_templates/:uid/patch)
