Reorder showcase products

Sets the display order of the products in a showcase. Requires both the products.update and showcases.update permissions.

The request must contain the complete set of product IDs currently in the showcase. If the supplied set does not match, the request is rejected with order_set_mismatch and the existing order remains unchanged. This operation does not move products between showcases; to change a product's showcase, update the product's showcase_id.

Send the showcase's current ETag value in the If-Match header to avoid overwriting a newer version.

Path Parameters

Header Parameters

Response Body

curl -X PUT "https://example.com/showcases/string/products/order" \  -H "Content-Type: application/json" \  -d '{    "ids": [      "string"    ]  }'

{  "data": [    {      "id": "string",      "name": "string",      "object": "product",      "position": 0,      "status": "published"    }  ],  "page": {    "limit": 1,    "next_cursor": "string",    "prev_cursor": "string"  }}