Update Product Image

🔒

Requires write_product access scope. More access scope

The Update Product Image API allows users to update the attributes of a specific product image, such as its source URL or position. By providing the product_id and image_id, users can precisely identify and modify the image's details. This API is useful for maintaining an up-to-date and accurate product catalog.This API is especially useful for:

  1. Modify the source or position of a specific product image to ensure accurate representation in the catalog.
  2. Optimize the order of images for better visual presentation.

Request Parameters

Public Request Parameters

📘

Public Request Parameters

Path Parameters

FieldTypeRequiredExampleDescription
product_idstringYes636a07da-39eb-4829-bde9-b65fae1c28b0The unique identifier of the product.
image_idstringYes91d032e7-bbc8-47e4-8668-9ba6fe714de6The unique identifier of the image.

Body Parameters

FieldTypeRequiredExampleDescription
image.srcstringNohttp://cdn.shoplazza.com/1.jpgThe new source URL of the image.
image.positionint32No2The new position of the image in the list. Must be greater than 0.

Response Explanation

Public Response Parameters

📘

Public Response Parameters

Success Response

Field Type Example Description
image.id string 91d032e7-bbc8-47e4-8668-9ba6fe714de6 The unique identifier for the image.
image.product_id string 636a07da-39eb-4829-bde9-b65fae1c28b0 The unique identifier for the product associated with the image.
image.position integer 1 The position of the image relative to other images in the product gallery.
image.src string //cdn.shoplazza.com/efd33b921cacd5311a32dd03a9bc8740.png The URL of the image.
image.width integer 1588 The width of the image in pixels.
image.height integer 2246 The height of the image in pixels.
image.alt string "" Alternative text for the image (used for accessibility or descriptions).
image.created_at string 2024-04-08T07:13:28Z The timestamp indicating when the image was created.
image.updated_at string 2024-04-08T07:13:28Z The timestamp indicating when the image was last updated.

Error Response

Error responses in the API can be represented using two different fields: errors and error. Both fields provide details about issues encountered during request processing. Below is an explanation of the fields with their respective examples and descriptions.

FieldTypeExampleDescription
errorsArray[ "Position must be greater than 0"]A list of errors encountered during the request processing.
FieldTypeExampleDescription
errorArray "store is not active"Indicates an error encountered during the process.

Error Details

Status CodeMessagePossible ReasonExample Response
400Bad RequestInvalid input format or request structure (e.g., missing required fields or incorrect data types).Bad Request
UnauthorizedThe request is missing valid authentication credentials or the credentials provided are invalid.Unauthorized
422position must be greater than 0The position provided in the request is invalid.{ "errors": ["Position must be greater than 0"] }

API Structure Overview

Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!