---
title: "Changes to Create an image"
method: POST
path: "/images"
---

# Changes to Create an image

`POST /images`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 14 revisions.

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

## Changes

- **2026-09-24** `745da36239a3`: 2 info
  - added the new `center-x-pin-bottom` enum value to the request property `modifications/objects/items/responsive-position`
  - added the new `center-y-pin-right` enum value to the request property `modifications/objects/items/responsive-position`
- **2026-09-23** `37156820eb24`: 2 info
  - added the new optional request property `modifications/objects/items/svg-url`
  - added the new `custom` enum value to the request property `modifications/objects/items/basic-shape`
- **2026-09-21** `708a5945d283`: 4 breaking, 18 info
  - removed the enum value `aurora, Aurora` of the request property `modifications/objects/items/motion-preset`
  - removed the enum value `conic, Conic spin` of the request property `modifications/objects/items/motion-preset`
  - removed the enum value `mesh, Mesh` of the request property `modifications/objects/items/motion-preset`
  - removed the enum value `pulse, Pulse` of the request property `modifications/objects/items/motion-preset`
  - added the new optional request property `modifications/objects/items/audio-url`
  - added the new optional request property `modifications/objects/items/background-crop`
  - added the new optional request property `modifications/objects/items/background-gradient`
  - added the new optional request property `modifications/objects/items/clip-mode`
  - added the new optional request property `modifications/objects/items/motion-color`
  - added the new optional request property `modifications/objects/items/wave-bars`
  - added the new optional request property `modifications/objects/items/wave-color`
  - added the new optional request property `modifications/objects/items/wave-envelope`
  - added the new optional request property `modifications/objects/items/wave-gap`
  - added the new optional request property `modifications/objects/items/wave-min-height`
  - added the new optional request property `modifications/objects/items/wave-mirror`
  - added the new optional request property `modifications/objects/items/wave-offset`
  - added the new optional request property `modifications/objects/items/wave-radius`
  - added the new optional request property `modifications/objects/items/wave-sensitivity`
  - added the new `aurora` enum value to the request property `modifications/objects/items/motion-preset`
  - added the new `conic` enum value to the request property `modifications/objects/items/motion-preset`
  - added the new `mesh` enum value to the request property `modifications/objects/items/motion-preset`
  - added the new `pulse` enum value to the request property `modifications/objects/items/motion-preset`
- **2026-09-18** `b62a85244712`: 6 info
  - added the new optional request property `modifications/objects/items/motion-blur`
  - added the new optional request property `modifications/objects/items/motion-cycle`
  - added the new optional request property `modifications/objects/items/motion-hue`
  - added the new optional request property `modifications/objects/items/motion-preset`
  - added the new optional request property `modifications/objects/items/motion-spread`
  - added the new optional request property `modifications/objects/items/motion-travel`
- **2026-09-09** `c439420dbe16`: 1 info
  - added the new optional request property `modifications/objects/items/text-highlight-shadow`
- **2026-09-09** `b98735eaab44`: 1 info
  - added the new optional request property `modifications/objects/items/ai-model`
- **2026-09-01** `6aa425420a10`: 6 breaking, 4 warning, 18 info
  - removed the enum value `` of the request property `modifications/objects/items/font-style-secondary`
  - removed the enum value `` of the request property `modifications/objects/items/font-weight-secondary`
  - removed the enum value `` of the request property `modifications/objects/items/text-decoration-secondary`
  - removed the enum value `` of the request property `modifications/objects/items/text-transform-secondary`
  - the `modifications/objects/items/font-weight` request property type changed from `string` to `number`
  - the `modifications/objects/items/font-weight-secondary` request property type changed from `string` to `number`
  - removed the request property `modifications/objects/items/adaptive-anchor-gap`
  - removed the request property `modifications/objects/items/adaptive-aspect-ratio`
  - removed the request property `modifications/objects/items/adaptive-position`
  - removed the request property `modifications/objects/items/adaptive-size`
  - added the new optional request property `modifications/objects/items/lottie-delay`
  - added the new optional request property `modifications/objects/items/lottie-loop`
  - added the new optional request property `modifications/objects/items/lottie-url`
  - added the new optional request property `modifications/objects/items/responsive-anchor-gap`
  - added the new optional request property `modifications/objects/items/responsive-aspect-ratio`
  - added the new optional request property `modifications/objects/items/responsive-position`
  - added the new optional request property `modifications/objects/items/responsive-size`
  - added the new optional request property `modifications/objects/items/text-highlight-border-radius`
  - the request property `modifications/objects/items/font-style-secondary` became nullable
  - the request property `modifications/objects/items/font-weight-secondary` became nullable
  - the request property `modifications/objects/items/text-decoration-secondary` became nullable
  - the request property `modifications/objects/items/text-transform-secondary` became nullable
  - added the non-success response with the status `402`
  - 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 `408`
  - added the non-success response with the status `422`
  - added the success response with the status `200`

---

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