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

# Changes to Create image edit

`POST /images/edits`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 88 revisions.

- **2026-10-28** `7ec2b6e4b626`: 2 info
- **2026-10-15** `b64a79b5e77c`: 6 info
- **2026-10-06** `487892d3954e`: 6 info
- **2026-10-05** `2fc1bd5fdd82`: 1 breaking, 1 info
- **2026-10-05** `7f654af7f94f`: 9 breaking, 36 info

## Changes

- **2026-10-28** `7ec2b6e4b626`: 2 info
  - added the new optional request property `markup` (media type: multipart/form-data)
  - added the new optional request property `markup` (media type: application/json)
- **2026-10-15** `b64a79b5e77c`: 6 info
  - added the new optional request property `safety_identifier` (media type: multipart/form-data)
  - added the new optional request property `safety_identifier` (media type: application/json)
  - request property `user` deprecated (media type: multipart/form-data)
  - request property `user` deprecated (media type: application/json)
  - added the optional property `anyOf[#/components/schemas/ImageEditCompletedEvent]/safety_identifier` to the response with the `200` status (media type: text/event-stream)
  - added the optional property `safety_identifier` to the response with the `200` status (media type: application/json)
- **2026-10-06** `487892d3954e`: 6 info
  - added the optional property `error/misalignment/review_target` to the response with the `400` status
  - added the optional property `error/misalignment/review_target` to the response with the `403` status
  - added the optional property `error/misalignment/review_target` to the response with the `410` status
  - added the optional property `error/misalignment/review_target` to the response with the `429` status
  - added the optional property `error/misalignment/review_target` to the response with the `500` status
  - added the optional property `error/misalignment/review_target` to the response with the `503` status
- **2026-10-05** `2fc1bd5fdd82`: 1 breaking, 1 info
  - the request property `response_format` became not nullable
  - added the new `undefined` enum value to the request property `response_format`
- **2026-10-05** `7f654af7f94f`: 9 breaking, 36 info
  - the request property `model` became not nullable
  - the request property `n` became not nullable
  - the request property `size` became not nullable
  - the request property `model` became required
  - removed the enum value `1024x1024` of the request property `size`
  - removed the enum value `256x256` of the request property `size`
  - removed the enum value `512x512` of the request property `size`
  - the response's body type changed from no type to `object` for status `200`
  - the response property `data` became optional for the status `200`
  - added the new optional request property `background`
  - added the new optional request property `input_fidelity`
  - added the new optional request property `output_compression`
  - added the new optional request property `output_format`
  - added the new optional request property `partial_images`
  - added the new optional request property `quality`
  - added the new optional request property `stream`
  - added the media type `application/json` to the request body
  - the `size` request property default value changed from `1024x1024` to `auto`
  - the `model` request property default value `dall-e-2` was removed
  - the `response_format` request property default value `url` was removed
  - request property `response_format` deprecated
  - added the new `chatgpt-image-latest` enum value to the request property `model/anyOf[subschema #2]/`
  - added the new `gpt-image-1` enum value to the request property `model/anyOf[subschema #2]/`
  - added the new `gpt-image-1-mini` enum value to the request property `model/anyOf[subschema #2]/`
  - added the new `gpt-image-1.5` enum value to the request property `model/anyOf[subschema #2]/`
  - added the new `gpt-image-2` enum value to the request property `model/anyOf[subschema #2]/`
  - added the new `gpt-image-2-2026-04-21` enum value to the request property `model/anyOf[subschema #2]/`
  - added the new `gpt-image-2.5-flare` enum value to the request property `model/anyOf[subschema #2]/`
  - added the new `gpt-image-2.5-flare-2026-09-08` enum value to the request property `model/anyOf[subschema #2]/`
  - added the new `gpt-image-2.5-sunburst` enum value to the request property `model/anyOf[subschema #2]/`
  - added the new `gpt-image-2.5-sunburst-2026-09-08` enum value to the request property `model/anyOf[subschema #2]/`
  - request property `image` list-of-types was widened by adding types `array` to media type `multipart/form-data`
  - request property `size` list-of-types was widened by adding types `null` to media type `multipart/form-data`
  - added the media type `text/event-stream` for the response with the status `200`
  - 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 `410`
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`
  - added the non-success response with the status `503`
  - …5 more

---

[Operation](https://skmtc.dev/omnistack-sh/apis/openai-api/docs/images/edits/post.md) - [API](https://skmtc.dev/omnistack-sh/apis/openai-api.md) - [Page](https://skmtc.dev/omnistack-sh/apis/openai-api/changes/images/edits/post)