Create product image

POST 
/openapi/2026-07/products/:product_id/images

Create a new product image with the provided details.

Request

Path Parameters

product_id stringrequired

The unique identifier for the product

application/json

Body

Bodyrequired

image objectrequired

Image

srcstringrequired

The URL of the image. Must be a valid URL

altstring

Alternative text for the image (used for accessibility or descriptions)

widthint32

The width of the image in pixels. Must be greater than 0

heightint32

The height of the image in pixels. Must be greater than 0

positionint32

The position of the image relative to other images. Must be greater than 0

Example

{
  "image": {
    "src": "string",
    "alt": "string",
    "width": 0,
    "height": 0,
    "position": 0
  }
}

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

image object

Image

idstring

The unique identifier for the image

product_idstring

The unique identifier for the product associated with the image

positionint32

The position of the image relative to other images in the product gallery

srcstring

The URL of the image

widthint32

The width of the image in pixels

heightint32

The height of the image in pixels

altstring

Alternative text for the image (used for accessibility or descriptions)

created_atstring

Image creation time

updated_atstring

Image last updated time

Example

{
  "code": "string",
  "message": "string",
  "data": {
    "image": {
      "id": "string",
      "product_id": "string",
      "position": 0,
      "src": "string",
      "width": 0,
      "height": 0,
      "alt": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  }
}