Update a modifier

PUT 
https://euwest.api.elasticpath.com/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.

application/json

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

200

Successfully returns the updated modifier.

application/json

Schema

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]

Example (from schema)

{
  "data": {
    "id": "string",
    "type": "product-variation-modifier",
    "attributes": {
      "type": "commodity_type",
      "value": "string",
      "seek": "string",
      "set": "string",
      "reference_name": "string"
    },
    "meta": {
      "owner": "organization"
    }
  }
}

updated-variation-modifier

{
  "data": {
    "type": "product-variation-modifier",
    "id": "68ec4892-9e4c-4154-a9fd-f5a9fb1f6878",
    "attributes": {
      "type": "sku_equals",
      "value": "newSku"
    },
    "meta": {
      "owner": "store"
    }
  }
}

403

Forbidden

application/json

Schema

Schema

errors undefined[]required
Array [
status stringrequired
The HTTP response code of the error.
title stringrequired
A brief summary of the error.
detail string
Optional additional detail about the error.
request_id string
Internal request ID.
meta object
Additional supporting meta data for the error.
]

Example (from schema)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "request_id": "00000000-0000-0000-0000-000000000000",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

internal-server-error

{
  "errors": [
    {
      "title": "Forbidden",
      "status": "403",
      "detail": "entity owned by organization"
    }
  ]
}

404

Bad Request. Not Found.

application/json

Schema

Schema

errors undefined[]required
Array [
status stringrequired
The HTTP response code of the error.
title stringrequired
A brief summary of the error.
detail string
Optional additional detail about the error.
request_id string
Internal request ID.
meta object
Additional supporting meta data for the error.
]

Example (from schema)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "request_id": "00000000-0000-0000-0000-000000000000",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

internal-server-error

{
  "errors": [
    {
      "title": "Not Found",
      "status": "404"
    }
  ]
}

409

Write conflict detected

application/json

Schema

Schema

errors undefined[]required
Array [
status stringrequired
The HTTP response code of the error.
title stringrequired
A brief summary of the error.
detail string
Optional additional detail about the error.
request_id string
Internal request ID.
meta object
Additional supporting meta data for the error.
]

Example (from schema)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "request_id": "00000000-0000-0000-0000-000000000000",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

internal-server-error

{
  "errors": [
    {
      "title": "Conflict",
      "status": "409",
      "detail": "write conflict detected"
    }
  ]
}

422

Bad request. The request failed validation.

application/json

Schema

Schema

errors undefined[]required
Array [
status stringrequired
The HTTP response code of the error.
title stringrequired
A brief summary of the error.
detail string
Optional additional detail about the error.
request_id string
Internal request ID.
meta object
Additional supporting meta data for the error.
]

Example (from schema)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "request_id": "00000000-0000-0000-0000-000000000000",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

failed-validation

{
  "errors": [
    {
      "title": "Failed Validation",
      "status": "422",
      "detail": "<XYZ> can not be empty"
    }
  ]
}

500

Internal server error. There was a system failure in the platform.

application/json

Schema

Schema

errors undefined[]required
Array [
status stringrequired
The HTTP response code of the error.
title stringrequired
A brief summary of the error.
detail string
Optional additional detail about the error.
request_id string
Internal request ID.
meta object
Additional supporting meta data for the error.
]

Example (from schema)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "request_id": "00000000-0000-0000-0000-000000000000",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

internal-server-error

{
  "errors": [
    {
      "status": "500",
      "title": "Internal Server Error",
      "detail": "There was an internal server error, you can report with your request id.",
      "request_id": "635da56d-75a1-43cd-b696-7ab119756b3a"
    }
  ]
}

Authorization: http

name: bearerAuthtype: httpscheme: bearer

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X PUT 'https://euwest.api.elasticpath.com/pcm/variations/:variationID/options/:optionID/modifiers/:modifierID' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "data": {
    "type": "product-variation-modifier",
    "attributes": {
      "type": "commodity_type",
      "value": "string",
      "seek": "string",
      "set": "string",
      "reference_name": "string"
    },
    "id": "00000000-0000-0000-0000-000000000000"
  }
}'

Request Collapse all

Base URL

https://euwest.api.elasticpath.com

Auth

Bearer Token

Parameters

variationID — pathrequired

optionID — pathrequired

modifierID — pathrequired

Body

• Example (from schema)
• update-variation-modifier

{
  "data": {
    "type": "product-variation-modifier",
    "attributes": {
      "type": "commodity_type",
      "value": "string",
      "seek": "string",
      "set": "string",
      "reference_name": "string"
    },
    "id": "00000000-0000-0000-0000-000000000000"
  }
}

ResponseClear

Click the Send API Request button above and see the response here!