Update product image

PUT 
/openapi/2026-07/products/:product_id/images/:image_id

Update the details of an existing product image using its unique identifier.

Request

Path Parameters

product_id stringrequired

The unique identifier for the product

image_id stringrequired

The unique identifier of the image

application/json

Body

Bodyrequired

image objectrequired

Image

srcstring

The new source URL of the image

positionint32

The new position of the image in the list. Must be greater than 0

Example

{
  "image": {
    "src": "string",
    "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"
    }
  }
}