---
title: "Register an uploaded image into the shop's media library"
method: POST
path: "/channel-api/v1.0/media/images"
tags: ["Previews", "Shops"]
---

# Register an uploaded image into the shop's media library

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

Returns a media image id to reference as a region's `imageId` in POST /previews.

## Request body

- ComFourthwallAppChannelShopModelRegisterMediaImageXRequest
  - `fileUrl` string, required — URL of the uploaded artwork, as returned by POST /upload-url (`fileUrl`).
  - `width` integer, required — Pixel width of the uploaded artwork.
  - `height` integer, required — Pixel height of the uploaded artwork.

## Response `201`

Created

- ComFourthwallAppChannelShopModelRegisterMediaImageXResponse
  - `id` string, required — Media image id. Pass this as a region's `imageId` to POST /previews.
  - `uri` string, required
  - `width` integer, required
  - `height` integer, required

---

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