Update an existing product.

This endpoint lets you modify an existing product. You can update various aspects of the product, including:

General Details: Edit core information like title, description, price, and inventory.

Grouped Products: Manage the structure of grouped products (add, remove, or change linked products).

Product Badges: Assign, remove, or update the badge associated with the product.

Creating or modifying variants of a product

To modify or add options (variants) to the product, populate the variants
array in the request body. Each object in the variants array can either
update an existing variant (by specifying its id) or add a new variant (if id is omitted).

Alternatively, you can use the
Add Product Variants
endpoint to add new variants to the product.

🔑Scopes

products.read_write - Products Read & Write

Request

Path Params

Header Params

Body Params application/json

Example

{
    "product_class": "string",
    "name": {
        "ar": "منتج جديد",
        "en": "New Product"
    },
    "price": 142.44,
    "short_description": null,
    "weight": {
        "value": null,
        "unit": "kg"
    },
    "badge": {
        "body": {
            "ar": "منتج مميز",
            "en": "Special Product"
        },
        "icon": {
            "code": "free_shipping"
        }
    },
    "group_products": [
        {
            "item_id": "143",
            "item_quantity": 3
        }
    ],
    "stocks": [
        {
            "available_quantity": 5,
            "is_infinite": false,
            "location": "string"
        }
    ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH 'https://api.zid.sa/v1/products//' \
--header 'Accept-Language;' \
--header 'Access-Token: eyJpdiI6Imh3L2dGbmJmRnVCOUY4WW5WQ2s3RFE9PSIsInZhbHVlIjoiZklpRnJyVGV1OWcrZUJBNk44bVp5SjZzSS92V3czcTJjbnJ2dFYvenZ3SFBtWHNSMFU3ZEMzZ0ZJNnpucVE4Ui9rNFdicUduOGpKUlg1VXdGOFFIaVUzZjZyUUZybWx3R0tNY3orUmxoUUUxQ29wSkEyVDZTVnVYb2dlUXJSVzBYVkdESjBpS0xiN05Hbndzc2wzV2N0YitGM1NEdkk4ckZZOTZsTFdEL1ZQRlJJTE5FQmttZng2elpwL1RCeXFRdUd1U3JTc0FHV1kySS80RFJaWlIyZ3gwM2FsQVRFbkt3VWtFOUQyKzdGOD0iLCJtYWMiOiJmZDQ0YzM4ODE0OWQxOWRhYWU0NDhhYmIzYzQ1MDAxMDAzODZjZGM3ZGM4NGJhMGNkMDEyYWZlM2UzYjAxMTI4IiwidGFnIjoiIn0=' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxMTciLCJqdGkiOiJhMTg5ZTg3MmYxMzhkMWVhYjU5MjVkMDkyMGE5NmI0YjliNjg0Y2E2ZTdmM2M2MjljZWYxNmQ4NDJjMmJlYmVhMjI4YTdmMTA0ZWQ4NWE5NCIsImlhdCI6MTY3OTU3Njk5OS41NjY4NzcsIm5iZiI6MTY3OTU3Njk5OS41NjY4OCwiZXhwIjoxNzExMTk5Mzk5LjQ4NjE1Mywic3ViIjoiMTgyNDc1Iiwic2NvcGVzIjpbInRoaXJkLXBhcnRpZXMtYXBpcyJdfQ.i07ef09nVNXGZF-g-QXpNoS2vlFQK_zntAqAMS4Az2XD2EyMLhxLZZRL-QlR11zUPqMmXjMAl_4ooKa3M3zkfZQ6Ga6qStvamk8RnC_39VUx0lfN2A4k65ERZpqwrMy6-t3dE99zay3aicIdNvbgi0zeuMSE5Tn99u-2AtSRa8ffbfAcYPPXacHrhdmlYzdiZS_x_skovFEow1E-nDjdL1WHqO92XdZ7RfNLkiYFTjZlZmM_UruvioaR3q6TXJbqRK_ZrziivezL8ohIQ2SBosUp58I29rlKzvlw_R2j0rKKYZbdxYDaxAHOISmOFKAlO66k7dNevAHI3s4uGIjoGA6ZXHknccWPLLLiaAQ0r64HV8GowW5dg2rhZNurJGDTnLlBQ6F-ql42ptHzSAfzzi576CEoN3gMVpgXcbntUY3reETkFsTBPUjeSuMpANMioXAA0GRp3Ut-84fTnrWxqsCW1WVUIx33HvmfCGPXIdkaCCWoA6G6KXo04MtFbKXQmXkK9esQWI-rqdVnMD3zSR3g3yFHZSL1U-mZeNja03706Rav1ordsRNOtRwtLuoRRbk9KasbUpEwqq4Ao9lqZZwRIjdEw-pQtnUT8V53fhmuuRIefCLFO7eGEtGUnh9o6Uh_pgi6AB6uSlnN9GEMGgI1alqvMmTjxvC-HHt0V-Y' \
--header 'Store-Id: 37213' \
--header 'Role: Manager' \
--header 'Content-Type: application/json' \
--data-raw '{
    "product_class": "string",
    "name": {
        "ar": "منتج جديد",
        "en": "New Product"
    },
    "price": 142.44,
    "short_description": null,
    "weight": {
        "value": null,
        "unit": "kg"
    },
    "badge": {
        "body": {
            "ar": "منتج مميز",
            "en": "Special Product"
        },
        "icon": {
            "code": "free_shipping"
        }
    },
    "group_products": [
        {
            "item_id": "143",
            "item_quantity": 3
        }
    ],
    "stocks": [
        {
            "available_quantity": 5,
            "is_infinite": false,
            "location": "string"
        }
    ]
}'

Responses

🟢200Product information is updated

application/json

Body