Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.

Set Manual Product Order

POST

https://api.zid.sa/v1/products/ordering/

Sets a custom ordering of products by accepting an ordered list of product IDs. This manual sorting can also be applied to a specific category when the category ID is passed in the body.

🔑Scopes

products.read_write - Products Read & Write

Request

Header Params

Body Params application/json

Example

{
    "products": [
        "d22fb4a6-cbcf-464c-8877-6cbf3df52056",
        "d22fb4a6-cbcf-46g5-8877-6c367f52053"
    ],
    "category": 0
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.zid.sa/v1/products/ordering/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Store-Id: {{StoreId}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "products": [
        "d22fb4a6-cbcf-464c-8877-6cbf3df52056",
        "d22fb4a6-cbcf-46g5-8877-6c367f52053"
    ],
    "category": 0
}'

Responses

🟢200Products Sorted Successfully in te given category

application/json

Body

Example

{}

🟠401Unauthorized

🔴500Internal Server error

🟠400Bad Request

Modified at 2026-02-15 16:16:23

Product Sorting

Reset Manual Product Order