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

# Changes to Create image edit

`POST /images/edits`

> Every recorded change to this endpoint, newest first.
> 168 revisions in range; 1 not diffed.

## Timeline

Changed in 7 of 168 revisions.

- **2026-09-25** `d86203de41ae` — 4 info
- **2026-09-08** `185927e212ab` — 1 breaking, 6 warning, 27 info
- **2026-09-03** `9430b00d75b4` — 2 info
- **2026-09-03** `5f6acbcbb919` — 2 info
- **2026-08-20** `5de4ab93fa24` — 4 info
- **2026-05-13** `74cbcf73838f` — 6 breaking, 20 info
- **2025-04-29** `6a6c681b1820` — 2 breaking, 7 info

## Changes

- **2026-09-25** `d86203de41ae` — 4 info
  - 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 `500`
- **2026-09-08** `185927e212ab` — 1 breaking, 6 warning, 27 info
  - the `size` response's property type changed from `string` to no type for status `200` (media type: application/json)
  - added the new `max` enum value to the `anyOf[#/components/schemas/ImageEditCompletedEvent]/quality` response property for the response status `200` (media type: text/event-stream)
  - added the new `max` enum value to the `anyOf[#/components/schemas/ImageEditPartialImageEvent]/quality` response property for the response status `200` (media type: text/event-stream)
  - added the new `max` enum value to the `quality` response property for the response status `200` (media type: application/json)
  - added the new `xhigh` enum value to the `anyOf[#/components/schemas/ImageEditCompletedEvent]/quality` response property for the response status `200` (media type: text/event-stream)
  - added the new `xhigh` enum value to the `anyOf[#/components/schemas/ImageEditPartialImageEvent]/quality` response property for the response status `200` (media type: text/event-stream)
  - added the new `xhigh` enum value to the `quality` response property for the response status `200` (media type: application/json)
  - added `subschema #1` to the `size` request property `anyOf` list (media type: application/json)
  - added the new `gpt-image-2.5-flare` enum value to the request property `model/anyOf[subschema #2]/` (media type: multipart/form-data)
  - added the new `gpt-image-2.5-flare` enum value to the request property `model/anyOf[subschema #2]/` (media type: application/json)
  - added the new `gpt-image-2.5-flare-2026-09-08` enum value to the request property `model/anyOf[subschema #2]/` (media type: multipart/form-data)
  - added the new `gpt-image-2.5-flare-2026-09-08` enum value to the request property `model/anyOf[subschema #2]/` (media type: application/json)
  - added the new `gpt-image-2.5-sunburst` enum value to the request property `model/anyOf[subschema #2]/` (media type: multipart/form-data)
  - added the new `gpt-image-2.5-sunburst` enum value to the request property `model/anyOf[subschema #2]/` (media type: application/json)
  - added the new `gpt-image-2.5-sunburst-2026-09-08` enum value to the request property `model/anyOf[subschema #2]/` (media type: multipart/form-data)
  - added the new `gpt-image-2.5-sunburst-2026-09-08` enum value to the request property `model/anyOf[subschema #2]/` (media type: application/json)
  - added the new `max` enum value to the request property `quality` (media type: multipart/form-data)
  - added the new `max` enum value to the request property `quality/anyOf[subschema #1]/` (media type: application/json)
  - added the new `xhigh` enum value to the request property `quality` (media type: multipart/form-data)
  - added the new `xhigh` enum value to the request property `quality/anyOf[subschema #1]/` (media type: application/json)
  - added `subschema #1, subschema #2` to the `anyOf[#/components/schemas/ImageEditCompletedEvent]/size` response property `anyOf` list for the response status `200` (media type: text/event-stream)
  - added `subschema #1, subschema #2` to the `anyOf[#/components/schemas/ImageEditPartialImageEvent]/size` response property `anyOf` list for the response status `200` (media type: text/event-stream)
  - added `subschema #1, subschema #2` to the `size` response property `anyOf` list for the response status `200` (media type: application/json)
  - removed the `1024x1024` enum value from the `anyOf[#/components/schemas/ImageEditCompletedEvent]/size` response property for the response status `200` (media type: text/event-stream)
  - removed the `1024x1024` enum value from the `anyOf[#/components/schemas/ImageEditPartialImageEvent]/size` response property for the response status `200` (media type: text/event-stream)
  - removed the `1024x1024` enum value from the `size` response property for the response status `200` (media type: application/json)
  - removed the `1024x1536` enum value from the `anyOf[#/components/schemas/ImageEditCompletedEvent]/size` response property for the response status `200` (media type: text/event-stream)
  - removed the `1024x1536` enum value from the `anyOf[#/components/schemas/ImageEditPartialImageEvent]/size` response property for the response status `200` (media type: text/event-stream)
  - removed the `1024x1536` enum value from the `size` response property for the response status `200` (media type: application/json)
  - removed the `1536x1024` enum value from the `anyOf[#/components/schemas/ImageEditCompletedEvent]/size` response property for the response status `200` (media type: text/event-stream)
  - removed the `1536x1024` enum value from the `anyOf[#/components/schemas/ImageEditPartialImageEvent]/size` response property for the response status `200` (media type: text/event-stream)
  - removed the `1536x1024` enum value from the `size` response property for the response status `200` (media type: application/json)
  - removed the `auto` enum value from the `anyOf[#/components/schemas/ImageEditCompletedEvent]/size` response property for the response status `200` (media type: text/event-stream)
  - removed the `auto` enum value from the `anyOf[#/components/schemas/ImageEditPartialImageEvent]/size` response property for the response status `200` (media type: text/event-stream)
- **2026-09-03** `9430b00d75b4` — 2 info
  - added the optional property `error/misalignment` to the response with the `429` status
  - added the optional property `error/misalignment` to the response with the `503` status
- **2026-09-03** `5f6acbcbb919` — 2 info
  - added the non-success response with the status `429`
  - added the non-success response with the status `503`
- **2026-08-20** `5de4ab93fa24` — 4 info
  - added the new `gpt-image-2` enum value to the request property `model/anyOf[subschema #2]/` (media type: multipart/form-data)
  - added the new `gpt-image-2` enum value to the request property `model/anyOf[subschema #2]/` (media type: application/json)
  - added the new `gpt-image-2-2026-04-21` enum value to the request property `model/anyOf[subschema #2]/` (media type: multipart/form-data)
  - added the new `gpt-image-2-2026-04-21` enum value to the request property `model/anyOf[subschema #2]/` (media type: application/json)
- **2026-05-13** `74cbcf73838f` — 6 breaking, 20 info
  - removed the enum value `1024x1024` of the request property `size`
  - removed the enum value `1024x1536` of the request property `size`
  - removed the enum value `1536x1024` 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`
  - removed the enum value `auto` of the request property `size`
  - 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 `stream`
  - added the media type `application/json` to the request body
  - added `subschema #1, subschema #2` to the `size` request property `anyOf` list
  - the `model` request property default value changed from `dall-e-2` to `gpt-image-1.5`
  - the `response_format` request property default value `url` was removed
  - added the new `chatgpt-image-latest` 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]/`
  - the `size` request property type was generalized from `string` to no type
  - added the media type `text/event-stream` for the response with the status `200`
  - added the optional property `background` to the response with the `200` status
  - added the optional property `output_format` to the response with the `200` status
  - added the optional property `quality` to the response with the `200` status
  - added the optional property `size` to the response with the `200` status
  - added the optional property `usage/output_tokens_details` to the response with the `200` status
- **2025-04-29** `6a6c681b1820` — 2 breaking, 7 info
  - 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 `quality`
  - added the new `1024x1536` enum value to the request property `size`
  - added the new `1536x1024` enum value to the request property `size`
  - added the new `auto` enum value to the request property `size`
  - added the new `gpt-image-1` 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`
  - added the optional property `usage` to the response with the `200` status

---

[Operation](https://skmtc.dev/openai/apis/openapi/docs/images/edits/post.md) · [API](https://skmtc.dev/openai/apis/openapi.md) · [Page](https://skmtc.dev/openai/apis/openapi/changes/images/edits/post)