Update Product images

Requires write_products access scope.

For more info , refer to:

[]

access permission

PUT https://{handle}.myshopline.com/admin/openapi/v20250601/products/:product_id/images/:image_id.json

[]

handle : The store's unique identifier, which is the prefix of the store's domain name. For example, if a store's domain name is open001.myshopline.com , the store handle is open001 .

[]

Update Product images

Path Parameters

image_id string required
[]
Picture id
product_id string required
[]
Product ID

Request Headers

Content-Type required
[]
The value of this field is fixed to application/json; charset=utf-8
Authorization string required
[]
The access token for the API. Please refer to App authorization to obtain the access token, and then put the obtained access token into the API request header in Bearer Token.
Example:
[]
Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw

Request Body

imageobject
[]
Image information
alt string
[]
Alt information of the image , limited to 512 characters
[]
Example: This is a image alt
position integer
[]
Image position
[]
Example: 1
sku_id string
[]
Variant id
[]
Example: 18057850264851626133510282

Response

[]

For more information about status codes, see Http status code.

Response Headers

traceId
[]
traceId

Response Body

imageobject
[]
Image information
alt string
[]
Image alt
[]
Example: This is a image alt
create_time string
[]
Creation time
[]
Example: 2023-01-31T13:22:37+08:00
height integer
[]
Image height
[]
Example: 1280
id string
[]
Image id
[]
Example: 5785060242375689228
position integer
[]
Image location
[]
Example: 1
product_id string
[]
Product ID
[]
Example: 16057850264845250791280282
sku_id string
[]
Variant ID
[]
Example: 18057850264851626133510282
src string
[]
Image src
[]
Example: https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
update_time string
[]
Update time
[]
Example: 2023-01-31T13:22:37+08:00
width integer
[]
Image width
[]
Example: 1280

API Explorer

Debugger

Examples

Base URL

https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601

ParamOptions

image_id — path required

product_id — path required

Authorization — header required

Body

Body required

{
  "image": {
    "alt": "This is a image alt",
    "position": 1,
    "sku_id": "18057850264851626133510282"
  }
}

Language

curl --request PUT \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601/products/product_id/images/image_id.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'

Was this article helpful to you?

SHOPLINE

Legal