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

Update Custom Option

PUT

https://api.zid.sa/v1/products/{product_id}/custom_options_fields/{custom_option_field_id}/

Updates an existing custom option field. This endpoint will replace the old data with the new data passed in the payload of this endpoint request.

🔑Scopes

products.read_write - Products Read & Write

Request

Path Params

Header Params

Body Params application/json

Example

{
    "id": "a8b0e6ce-6937-4c56-8253-9478d0f28475",
    "type": "CHECKBOX",
    "hint": {
        "ar": "يرجى اختيار الخيار المناسب",
        "en": "Please select a suitable option"
    },
    "label": {
        "ar": "خيار مخصص",
        "en": "custom option"
    },
    "min_choices": 1,
    "max_choices": 50,
    "is_required": false,
    "can_choose_multiple_options": true,
    "choices": [
        {
            "price": 66.5,
            "id": "0908e710-f3fe-4c56-80c0-bd317c8e6f5d",
            "ar": "قيمة 1",
            "en": "value 1"
        }
    ],
    "display_order": 4,
    "visibility_condition": null,
    "is_published": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.zid.sa/v1/products/e0ad7a76-ba42-4c59-94c9-0da600117fbf/custom_options_fields/a8b0e6ce-6937-4c56-8253-9478d0f28475/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Store-Id: {{StoreId}}' \
--header 'Accept-Language: en' \
--header 'Role: Manager' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "a8b0e6ce-6937-4c56-8253-9478d0f28475",
    "type": "CHECKBOX",
    "hint": {
        "ar": "يرجى اختيار الخيار المناسب",
        "en": "Please select a suitable option"
    },
    "label": {
        "ar": "خيار مخصص",
        "en": "custom option"
    },
    "min_choices": 1,
    "max_choices": 50,
    "is_required": false,
    "can_choose_multiple_options": true,
    "choices": [
        {
            "price": 66.5,
            "id": "0908e710-f3fe-4c56-80c0-bd317c8e6f5d",
            "ar": "قيمة 1",
            "en": "value 1"
        }
    ],
    "display_order": 4,
    "visibility_condition": null,
    "is_published": true
}'

Responses

🟢200

application/json

Body

Example

{
    "id": "string",
    "type": "string",
    "label": {
        "ar": "string",
        "en": "string"
    },
    "hint": {
        "ar": "string",
        "en": "string"
    },
    "min_choices": 0,
    "max_choices": 0,
    "can_choose_multiple_options": true,
    "is_published": true,
    "is_required": true,
    "display_order": 0,
    "choices": [
        {
            "ar": "string",
            "en": "string",
            "price": 0,
            "id": "string"
        }
    ],
    "visibility_condition": {}
}

🟠401Unauthorized

🔴500Internal Server error

Modified at 2026-03-02 12:43:50

Create Custom Options

Delete Custom Option Field