Update SKU by ID

Requires write_products access scope.
For more info , refer to:
PUT https://{handle}.myshopline.com/admin/openapi/v20250601/products/variants/:variant_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 SKU by ID
Path Parameters
  • variant_id string required
    Variant id
    Example: 18057039439794751459380282
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
  • variantobject
    Variant information
  • barcode string
    Barcode , limited to 255 characters
    Example: T0000001
  • compare_at_price string
    Original price
    Example: 99
  • imageobject
    Images
  • alt string
    Alt information of the image , limited to 512 characters
    Example: alt
  • id string
    Image id , note : must be the image in the main image
    Example: 5785060242207917075
  • src string
    Corresponding image src link, limited to 255 characters
    Example: https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
  • inventory_policy string
    Oversold strategy , continue : allowed , deny : not allowed
    Example: deny
  • inventory_tracker boolean
    Track inventory , default is not tracking or not
    Example: true
  • option1 string
    The variant corresponds to the value of the option1 limited to 255 characters
    Example: Red
  • option2 string
    The variant corresponds to the value of the option2 limited to 255 characters
    Example: L
  • option3 string
    The variant corresponds to the value of the option3 limited to 255 characters
  • option4 string
    The variant corresponds to the value of the option4 limited to 255 characters
  • option5 string
    The variant corresponds to the value of the option5 limited to 255 characters
  • price string
    Selling price
    Example: 90
  • required_shipping boolean
    Shipping or not
    Example: true
  • sku string
    Sku code , limited to 255 characters
    Example: S0000001
  • taxable boolean
    Tax collection or not required
    Example: true
  • weight string
    Weight
    Example: 0.2
  • weight_unit string
    Weight unit: g，kg，lb，oz，zh_kg
    Example: kg
Response
For more information about status codes, see Http status code.
Response Headers
  • traceId
    traceId
Response Body
  • variantobject
    Variant information
  • barcode string
    Bar code
    Example: T00000001
  • compare_at_price string
    Original price
    Example: 99
  • created_at string
    Creation time
    Example: 2021-09-02T14:11:54+00:00
  • id string
    Variant id
    Example: 18057039439794751459380282
  • imageobject
    Images
  • alt string
    Picture alt
    Example: alt
  • id string
    Picture id
    Example: 5785060242207917075
  • src string
    Images src
    Example: https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
  • inventory_item_id string
    Stock object id
    Example: 5985060212307917075
  • inventory_policy string
    Oversold strategy
    Example: deny
  • inventory_quantity integer
    All locations summary of inventory
    Example: 99
  • inventory_tracker boolean
    Track inventory or not
    Example: true
  • option1 string
    The variant corresponds to the value of the option1 limited to 255 characters
    Example: Red
  • option2 string
    The variant corresponds to the value of the option2 limited to 255 characters
    Example: L
  • option3 string
    The variant corresponds to the value of the option3 limited to 255 characters
  • option4 string
    The variant corresponds to the value of the option4 limited to 255 characters
  • option5 string
    The variant corresponds to the value of the option5 limited to 255 characters
  • price string
    Selling price
    Example: 90
  • product_id string
    Product ID
    Example: 16057039432335097907370282
  • required_shipping boolean
    Tax collection or not required
    Example: true
  • sku string
    SKU code
    Example: S00000001
  • taxable boolean
    Tax collection or not required
    Example: true
  • updated_at string
    Update time
    Example: 2021-09-02T14:11:54+00:00
  • weight string
    Weight
    Example: 0.2
  • weight_unit string
    Weight units
    Example: kg
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601

ParamOptions

— path required
— header required

Body

required
{
  "variant": {
    "barcode": "T0000001",
    "compare_at_price": "99",
    "image": {
      "alt": "alt",
      "id": "5785060242207917075",
      "src": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png"
    },
    "inventory_policy": "deny",
    "inventory_tracker": true,
    "option1": "Red",
    "option2": "L",
    "option3": "",
    "option4": "",
    "option5": "",
    "price": "90",
    "required_shipping": true,
    "sku": "S0000001",
    "taxable": true,
    "weight": "0.2",
    "weight_unit": "kg"
  }
}

Language

curl --request PUT \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601/products/variants/variant_id.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'
Examples
Update
Request
{
  "variant": {
    "barcode": "T0000001",
    "compare_at_price": "99",
    "image": {
      "alt": "my image alt",
      "id": "6089530275430875206",
      "src": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png"
    },
    "inventory_policy": "deny",
    "inventory_tracker": "true",
    "option1": "L",
    "option2": "White",
    "price": "90",
    "required_shipping": "true",
    "sku": "S0000001",
    "taxable": "true",
    "weight": "0.2",
    "weight_unit": "kg"
  }
}
Response
{
  "variant": {
    "barcode": "T0000001",
    "compare_at_price": "99.00",
    "created_at": "2023-08-29T14:59:58+08:00",
    "id": "18060895302863070249743144",
    "image": {
      "alt": "my image alt",
      "id": "6089530275430875206",
      "src": "https://img-va.myshopline.com/image/store/2001026666/1653474941510/e46e6189dd5641a3b179444cacdcdd2a_15.png?w=1024&h=1024"
    },
    "inventory_item_id": "6089530288991379429",
    "inventory_policy": "deny",
    "inventory_tracker": true,
    "option1": "L",
    "option2": "White",
    "price": "90.00",
    "product_id": "16060895302856191591063144",
    "required_shipping": true,
    "sku": "S0000001",
    "taxable": true,
    "updated_at": "2023-08-29T15:10:42+08:00",
    "weight": "0.20",
    "weight_unit": "kg"
  }
}
Was this article helpful to you?
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
Legal
Privacy
Terms
Developer Agreement
LinkedInEmail
LinkedInEmail
© Copyright 2013-2025 SHOPLINE Limited.