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

Bulk Update Products

PATCH

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

This endpoint allows you to update multiple products at once by specifying their IDs or SKUs along with the new data. This makes managing large inventory updates more efficient.

🔑Scopes

products.read_write - Products Read & Write

Please note that submitting more than 50 IDs/SKUs for product updates may lead to processing issues. We recommend adhering to this constraint to ensure smooth operations.

Request

Header Params

Body Params application/json

Example

[
    {
        "id": "05d39420-f1ba-475a-b298-d67c5bfa017c",
        "sku": "Z.987654.1234567890",
        "name": {
            "ar": "تويتر",
            "en": "twitter"
        },
        "description": {
            "ar": "منتج اختبار",
            "en": "This is a test product"
        },
        "price": "12.444",
        "cost": "10",
        "is_draft": false,
        "quantity": 1,
        "is_infinite": false,
        "weight": {
            "unit": "kg",
            "value": 100
        },
        "keywords": [
            "apps",
            "social"
        ],
        "requires_shipping": true,
        "is_published": true
    }
]

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH 'https://api.zid.sa/v1/products/' \
--header 'Store-Id: 3' \
--header 'Accept-Language: en' \
--header 'Authorization: {{Autherization}}' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Role: Manager' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "id": "05d39420-f1ba-475a-b298-d67c5bfa017c",
        "sku": "Z.987654.1234567890",
        "name": {
            "ar": "تويتر",
            "en": "twitter"
        },
        "description": {
            "ar": "منتج اختبار",
            "en": "This is a test product"
        },
        "price": "12.444",
        "cost": "10",
        "is_draft": false,
        "quantity": 1,
        "is_infinite": false,
        "weight": {
            "unit": "kg",
            "value": 100
        },
        "keywords": [
            "apps",
            "social"
        ],
        "requires_shipping": true,
        "is_published": true
    }
]'

Responses

🟢200Successfully updated the bulk of products information.

application/json

Body

Example

[
    {
        "id": "05d39420-f1ba-475a-b298-d67c5bfa017c",
        "product_class": null,
        "sku": "Z.987654.1234567890",
        "barcode": "",
        "parent_id": null,
        "name": {
            "ar": "تويتر",
            "en": "twitter"
        },
        "slug": "testq",
        "price": 12.444,
        "short_description": {
            "ar": "",
            "en": ""
        },
        "sale_price": null,
        "formatted_price": " SAR 12.44",
        "formatted_sale_price": null,
        "currency": "SAR",
        "currency_symbol": " SAR ",
        "attributes": [],
        "categories": [],
        "display_order": 32766,
        "has_options": true,
        "has_fields": false,
        "images": [],
        "videos": [],
        "is_draft": false,
        "quantity": 1190,
        "is_infinite": false,
        "html_url": "https://osama.zid.store/products/testq",
        "weight": {
            "value": null,
            "unit": "kg"
        },
        "keywords": [
            "social",
            "apps"
        ],
        "requires_shipping": true,
        "is_taxable": true,
        "structure": "parent",
        "variants": [
            {}
        ],
        "options": [
            {
                "id": "string",
                "name": "string",
                "slug": "string",
                "choices": [
                    "string"
                ]
            }
        ],
        "stocks": [
            {
                "id": "string",
                "available_quantity": 0,
                "is_infinite": true
            }
        ],
        "created_at": "2026-01-26T13:25:19.467362Z",
        "updated_at": "2026-01-28T10:32:45.320380Z"
    }
]

🟠401Unauthorized

Modified at 2026-01-28 10:32:32

Update Product

Delete Product