Product Listing and Delisting

Batch update the listing status of products (on-sale or off-shelf).

Basic Information

Property	Value
Method	PUT
Path	/seller/product-spu/switch
Authentication	Bearer Token
Content-Type	application/json

Request Headers

Header	Type	Required	Description
Authorization	string	Yes	Bearer <accessToken>

Request Body Parameters

Parameter	Type	Required	Description
productSpuIds	array[integer]	Yes	Collection of product SPU IDs
productStatus	string	Yes	Target status: ON_SALE or SHELF_DOWN

Allowed productStatus values:

Value	Description
ON_SALE	On sale
SHELF_DOWN	Off shelf

Request Example

PUT /merchant-api/seller/product-spu/switch HTTP/1.1
Host: paas-gateway.imetastore.io
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json

{
  "productSpuIds": [2001591587541073922, 2001591587541073923],
  "productStatus": "ON_SALE"
}

Success Response

{
  "code": "0000",
  "msg": "Success",
  "time": "2025-12-17T13:44:16.000Z",
  "data": true
}