---
title: "Save an uploaded image to the media library"
method: POST
path: "/open-api/v1.0/media/images"
tags: ["Media Library"]
---

# Save an uploaded image to the media library

`POST /open-api/v1.0/media/images`

*Rate limit: 100 requests / 10 seconds per shop. See [Rate limiting](/guides/rate-limiting).*

Persists an uploaded image in the media library after the client has PUT it to the signed URL

## Request body

- ComFourthwallOpenapiModelMediaSaveMediaImageRequestV1
  - `fileUrl` string, required
  - `width` integer, required
  - `height` integer, required

## Response `201`

Created

- ComFourthwallOpenapiModelMediaMediaImageV1
  - `id` string, required
  - `uri` string, required
  - `width` integer, required
  - `height` integer, required
  - `thumbnail` string, required
  - `preview` string, required

## Other responses

- `400` — Possible errors: `UNTRUSTED_ASSET_SOURCE_ERROR`
- `404` — Possible errors: `MEDIA_FILE_DO_NOT_EXISTS`
- `429` — Rate limited: 100 requests / 10 seconds per shop.

---

[API](https://skmtc.net/fourthwall/apis/fourthwall-apis-2.md) · [All operations](https://skmtc.net/fourthwall/apis/fourthwall-apis-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthwall/fourthwall-apis-2/revisions/ef273312f051/schema)