---
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`

## Request

- Base URL: `https://api.fourthwall.com`
- URL: `https://api.fourthwall.com/channel-api/v1.0/media/images`
- Auth: none declared

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

## Changes

- **2026-07-21** `d922932087ce`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fourthwall/apis/fourthwall-apis-3/changes/channel-api/v1.0/media/images/post.md)

---

[API](https://skmtc.dev/fourthwall/apis/fourthwall-apis-3.md) - [All operations](https://skmtc.dev/fourthwall/apis/fourthwall-apis-3/llms.txt) - [OpenAPI document](https://skmtc.dev/fourthwall/apis/fourthwall-apis-3/revisions/ebc29b226337?raw)