---
title: "Changes to Upload image"
method: POST
path: "/uploads/image"
---

# Changes to Upload image

`POST /uploads/image`

> Every recorded change to this operation, newest first.
> 576 revisions in range; 3 not diffed.

## Timeline

Changed in 4 of 576 revisions.

- **2026-10-12** `30f95dce0284`: 2 info
- **2026-02-13** `72a8c35a3c01`: 9 breaking, 9 info
- **2025-09-26** `bea9a06bb03a`: 1 info
- **2025-07-18** `ecf82915c7e4`: 1 info

## Changes

- **2026-10-12** `30f95dce0284`: 2 info
  - added the optional property `cooldown_remaining_ms` to the response with the `400` status
  - added the optional property `cooldown_remaining_ms` to the response with the `429` status
- **2026-02-13** `72a8c35a3c01`: 9 breaking, 9 info
  - removed the enum value `bottom` of the request property `upload_sizes/items/crop`
  - removed the enum value `center` of the request property `upload_sizes/items/crop`
  - removed the enum value `clip` of the request property `upload_sizes/items/resize`
  - removed the enum value `crop` of the request property `upload_sizes/items/resize`
  - removed the enum value `fill` of the request property `upload_sizes/items/resize`
  - removed the enum value `left` of the request property `upload_sizes/items/crop`
  - removed the enum value `right` of the request property `upload_sizes/items/crop`
  - removed the enum value `scale` of the request property `upload_sizes/items/resize`
  - removed the enum value `top` of the request property `upload_sizes/items/crop`
  - removed the `bottom` enum value from the `upload_sizes/items/crop` response property for the response status `201`
  - removed the `center` enum value from the `upload_sizes/items/crop` response property for the response status `201`
  - removed the `clip` enum value from the `upload_sizes/items/resize` response property for the response status `201`
  - removed the `crop` enum value from the `upload_sizes/items/resize` response property for the response status `201`
  - removed the `fill` enum value from the `upload_sizes/items/resize` response property for the response status `201`
  - removed the `left` enum value from the `upload_sizes/items/crop` response property for the response status `201`
  - removed the `right` enum value from the `upload_sizes/items/crop` response property for the response status `201`
  - removed the `scale` enum value from the `upload_sizes/items/resize` response property for the response status `201`
  - removed the `top` enum value from the `upload_sizes/items/crop` response property for the response status `201`
- **2025-09-26** `bea9a06bb03a`: 1 info
  - api operation id `UploadImageGlobal` removed and replaced with `UploadImage`
- **2025-07-18** `ecf82915c7e4`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/getstream/apis/stream-api/docs/uploads/image/post.md) - [API](https://skmtc.dev/getstream/apis/stream-api.md) - [Page](https://skmtc.dev/getstream/apis/stream-api/changes/uploads/image/post)