Skip to main content

Update a modifier

PUT 
/pcm/variations/:variationID/options/:optionID/modifiers/:modifierID

Specify whichever attributes you want to change. The values of the other attributes remain the same. If the attributes section is empty, the modifier is not updated.

Request​

Path Parameters

    variationID stringrequired

    A unique identifier for the variation.

    optionID stringrequired

    A unique identifier for the option.

    modifierID stringrequired

    A unique identifier for the modifier.

Body

    data objectrequired
    type stringrequired

    Possible values: [product-variation-modifier]

    This represents the type of resource object being returned. Always product-variation-modifier.

    attributes objectrequired
    type stringrequired

    Possible values: [commodity_type, status, price, name_append, name_prepend, name_equals, sku_append, sku_prepend, sku_equals, sku_builder, slug_append, slug_prepend, slug_equals, slug_builder, description_append, description_prepend, description_equals, custom_inputs_equals, build_rules_equals, locales_equals, upc_ean_equals, mpn_equals, external_ref_equals]

    You can specify different modifiers for different options in a variation. When you build child products using options in variations, the properties of a child products depends on the modifier set for the options that are applied to the child product. The table below describes the different types of modifiers.

    | Modifier | Data Type | Effect | | :--- | :--- | :--- | | name_equals | string | Overrides the name of the child product with the name specified by the modifier. | | name_append | string | Appends the string specified in the modifier to the name of the child product. | | name_prepend | string | Prepends the string specified in the modifier to the name of the child product. | | description_equals | string | Overrides the description of the child product. | | description_append | string | Appends the string specified in the modifier to the description of the child product. | | description_prepend | string | Prepends the string specified in the modifier to the product description of the child product. | | commodity_type | string | Sets the commodity type of the child product, such as physical or digital. | | price | string | Allows application of price modifiers (price_increment, price_decrement, and price_equals) to the child products. | | price_increment | string | Increases the price of the child product. | | price_decrement | string | Decreases the price of the child product. | | price_equals | string | Sets the price of a child product to the amount you specify. | | slug_append | string | Appends the string specified in the modifier to the slug of the child product. Can only contain A-Z, a-z, 0 to 9, hyphen, underscore, and period. Spaces or other special characters like ^, [], *, and $ are not allowed. However, for the slug-builder modifier, you can use {} in the seek field, for example, "seek": :{COLOR}". | | slug_prepend | string | Prepends the string specified in the modifier to the slug of the child product. Can only contain A-Z, a-z, 0 to 9, hyphen, underscore, and period. Spaces or other special characters like ^, [], *, and $ are not allowed. However, for the slug-builder modifier, you can use {} in the seek field, for example, "seek": :{COLOR}". | | slug_builder | string| Sets a part of the slug of the child product. Can only contain A-Z, a-z, 0 to 9, hyphen, underscore, and period. Spaces or other special characters like ^, [], *, and $ are not allowed. However, for the slug-builder modifier, you can use {} in the seek field, for example, "seek": :{COLOR}". | | sku_equals | string | Sets the SKU of the child product. | | sku_append | string | Appends the string specified in the modifier to the SKU of the child product. | | sku_prepend | string | Prepends the string specified in the modifier to the SKU of the child product. | | sku_builder | string | Sets a part of the SKU of the child product. | | status | string | Sets the status of the child product, such as draft or live. |

    value string

    Required for non-builder modifiers. The value of the modifier type.

    seek string

    Required for builder modifiers. The sub-string to find and replace enclosed in curly brackets for slug_builder and sku_builder.

    set string

    Required for builder modifiers. The value to replace matches the seek string for slug_builder and sku_builder.

    reference_name string

    The name of the modifier.

    id stringrequired

    The unique identifier of the modifier. Must match the modifier ID specified in the request path.

Responses​

Successfully returns the updated modifier.

Schema
    data object
    id string

    A unique identifier for a modifier that is generated automatically when a modifier is created.

    type string

    Possible values: [product-variation-modifier]

    This represents the type of resource object being returned. Always `product-variation-modifier'.

    attributes object
    type string

    Possible values: [commodity_type, status, price, name_append, name_prepend, name_equals, sku_append, sku_prepend, sku_equals, sku_builder, slug_append, slug_prepend, slug_equals, slug_builder, description_append, description_prepend, description_equals, custom_inputs_equals, build_rules_equals, locales_equals, upc_ean_equals, mpn_equals, external_ref_equals]

    You can specify different modifiers for different options in a variation. When you build child products using options in variations, the properties of a child products depends on the modifier set for the options that are applied to the child product. The table below describes the different types of modifiers.

    | Modifier | Data Type | Effect | | :--- | :--- | :--- | | name_equals | string | Overrides the name of the child product with the name specified by the modifier. | | name_append | string | Appends the string specified in the modifier to the name of the child product. | | name_prepend | string | Prepends the string specified in the modifier to the name of the child product. | | description_equals | string | Overrides the description of the child product. | | description_append | string | Appends the string specified in the modifier to the description of the child product. | | description_prepend | string | Prepends the string specified in the modifier to the product description of the child product. | | commodity_type | string | Sets the commodity type of the child product, such as physical or digital. | | price | string | Allows application of price modifiers (price_increment, price_decrement, and price_equals) to the child products. | | price_increment | string | Increases the price of the child product. | | price_decrement | string | Decreases the price of the child product. | | price_equals | string | Sets the price of a child product to the amount you specify. | | slug_append | string | Appends the string specified in the modifier to the slug of the child product. Can only contain A-Z, a-z, 0 to 9, hyphen, underscore, and period. Spaces or other special characters like ^, [], *, and $ are not allowed. However, for the slug-builder modifier, you can use {} in the seek field, for example, "seek": :{COLOR}". | | slug_prepend | string | Prepends the string specified in the modifier to the slug of the child product. Can only contain A-Z, a-z, 0 to 9, hyphen, underscore, and period. Spaces or other special characters like ^, [], *, and $ are not allowed. However, for the slug-builder modifier, you can use {} in the seek field, for example, "seek": :{COLOR}". | | slug_builder | string| Sets a part of the slug of the child product. Can only contain A-Z, a-z, 0 to 9, hyphen, underscore, and period. Spaces or other special characters like ^, [], *, and $ are not allowed. However, for the slug-builder modifier, you can use {} in the seek field, for example, "seek": :{COLOR}". | | sku_equals | string | Sets the SKU of the child product. | | sku_append | string | Appends the string specified in the modifier to the SKU of the child product. | | sku_prepend | string | Prepends the string specified in the modifier to the SKU of the child product. | | sku_builder | string | Sets a part of the SKU of the child product. | | status | string | Sets the status of the child product, such as draft or live. |

    value string

    Required for non-builder modifiers. The value of the modifier type.

    seek string

    Required for builder modifiers. The sub-string to find and replace enclosed in curly brackets for slug_builder and sku_builder.

    set string

    Required for builder modifiers. The value to replace matches the seek string for slug_builder and sku_builder.

    reference_name string

    The name of the modifier.

    meta object

    The owner of the resource, either organization or store.

    owner string

    Possible values: [organization, store]

Loading...