Update Product Option - Salla Merchants APIs

This endpoint allows you to update specific option details for a specific product by passing the option as a path parameter.

Note

For the product.type variable set to product, updating product option with new values will generate new variants for these new values

When the old values are updated, they are removed as the new values are added.

Scopes

products.read_write- Products Read & Write

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Path Params

option

integer

required

The Option ID. List of Products Options ID can be found here.

Body Params application/json

name

string

optional

A distinctive label or title assigned to a specific item or commodity, serving as an identifier and often conveying essential information about the product.

required

boolean

optional

Whether or not the product option is required.

visibility

enum<string>

optional

Product option field visibilty.

Allowed values:

alwayson_condition

Default:

always

visibility_condition_type

enum<string>

optional

Visibility condition type. Required if the visibility variable is set to on_condition

Allowed values:

=!=><

visibility_condition_option

string

optional

The product option's ID for the condition. Required if the variable visibility is set to on_condition.

visibility_condition_value

string

optional

The product option value's ID for the condition. Required if the variable visibility is set to on_condition

display_type

enum<string>

optional

The various choices or variations of a product are visually presented to customers, typically categorized as text, image, or color representations.

Allowed values:

textimagecolor

Default:

text

values

array [object {5}]

optional

name

string

required

A descriptive label or title given to a specific attribute, feature, or characteristic associated with a product, helping to define and differentiate its various qualities or options.

price

number

optional

The additional price which will be added to the product price when the customer adds/selects this value. Alternatively the value is set 0 if there is no additional price.

quantity

integer

optional

The specific quantity or number of units available for a particular option or variation of a product.

Example:

display_value

string

optional

The display value in UI based on display type of option, by default will use the name of value as display value when the 'display_value=text', but in case you used 'image' then you need to set the image id as value You can upload a new image to product using attach image endpoint then use 'image' id from response, otherwise when use 'color' as display type you need to pass the color for example '#000' for black color

is_default

boolean

optional

The option to indicate if this value is the default value of the product option.

Example

{
  "name": "text update",
  "required": false,
  "sort": 44,
  "display_type": "text",
  "associated_with_order_time": false,
  "not_same_day_order": false,
  "availability_range": true,
  "visibility": "on_condition",
  "visibility_condition_type": "=",
  "visibility_condition_option": 131932457,
  "visibility_condition_value": 1516487768,
  "advance": true,
  "values": [
    {
      "name": "value new"
    },
    {
      "name": "value new 2"
    }
  ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢201Updated Successfully

application/json

Body

status

number

optional

Response status code, a numeric or alphanumeric identifier used to convey the outcome or status of a request, operation, or transaction in various systems and applications, typically indicating whether the action was successful, encountered an error, or resulted in a specific condition.

success

boolean

optional

Response flag, boolean indicator used to signal a particular condition or state in the response of a system or application, often representing the presence or absence of certain conditions or outcomes.

data

object (ProductOption)

optional

Detailed structure of the product option model object showing its fields and data types.

number

required

A unique identifier assigned to a specific product configuration or variant.

name

string

required

The label or title used to describe a specific choice or attribute associated with a product.

description

string | null

required

A text or content that provides detailed information about a product.

type

enum<string>

required

Type of the product option, it can be a radio button or checkbox

Allowed values:

radiocheckboxbutton

required

boolean

required

Whether or not the product option is obligatory.

associated_with_order_time

integer | boolean

required

The product option is only relevant to order receiving time when it pertains to date-time selections. ONLY for date time options.

sort

integer | null

required

Product option sort refers to the method or criteria used to arrange or order product options.

display_type

enum<string>

required

The manner in which product choices or attributes are presented.

Allowed values:

textimagecolor

visibility

enum<string>

required

Product option visibility based on condition is applied exclusively to products categorized as 'food' or 'service'.

Allowed values:

alwayson_condition

visibility_condition_type

enum<string>

required

Product option visiblity condition type

Allowed values:

><=!=

visibility_condition_option

integer | null

required

Whether or not Product option is visible.

visibility_condition_value

integer | null

required

A unique identifier associated with a specific value or choice within a product option.

values

array[object (ProductValue) {12}]

required

skus

array[object (ProductVariant) {21}]

required

Example

{
  "status": 201,
  "success": true,
  "data": {
    "id": 1130246629,
    "name": "size",
    "description": "This product is best seller",
    "type": "radio",
    "required": false,
    "associated_with_order_time": 0,
    "sort": 9,
    "display_type": "text",
    "visibility": "always",
    "values": [
      {
        "id": 322122678,
        "name": "XL",
        "price": {
          "amount": 180,
          "currency": "SAR"
        },
        "display_value": "XL",
        "option_id": 1130246629,
        "image_url": "https://i.ibb.co/jyqRQfQ/avatar-male.webp",
        "hashed_display_value": "XL"
      }
    ],
    "skus": [
      {
        "id": 652911549,
        "price": {
          "amount": 150,
          "currency": "SAR"
        },
        "regular_price": {
          "amount": 234,
          "currency": "SAR"
        },
        "stock_quantity": 3000,
        "barcode": "barcode-ABC",
        "sku": "sku-variant-1551119600",
        "related_option_values": [
          667315336,
          322122678
        ]
      }
    ]
  }
}

🟠404Not Found

🟠422Error Validation

🟠401Unauthorized