This call is deprecated. We recommend to use PIM API instead.
The corresponding new call is: POST /v1/matrix/dimension.
Create a matrix dimension, or add values to an existing dimension.
A matrix dimension is necessary for setting up matrix products. Typical matrix dimensions are, for example, "Size" (in which the values might be 2, 4, 6, 8 — or S, M, L, XL) and "Color" (which may contain Blue, Red, Black, Green etc).
Different matrix products can share the same dimensions, and a matrix product does not need to have variations corresponding to each value in the dimension. For example, it is sufficient to have just one dimension for all letter sizes, one for all numeric sizes and one for all kinds of colors.
Matrix products and their variations can be created with API call getProducts.
This API call is the best choice if you want to create a brand new dimension with a specific set of values. However, if a dimension already exists and you want to modify its list of values, see the following API calls instead:
dimensionID = ...the result will be as follows:
valueName1 = "Green"
valueCode1 = "123"
valueName2 = "Blue"
valueCode2 = "124"
|Parameter name||Description||Possible value||Required|
If this parameter is present the specified matrix dimension will be updated.
|name||Dimension name (eg. "Color" or "Size").||String|
|*****||Dimension values (pairs of names and codes) to be added and/or updated. Both name and code are required. The "#" symbol indicates the number of the pair; first pair should have names "valueName1" and "valueCode1", the second pair "valueName2" and "valueCode2", etc.|
|dimensionID||Integer||ID of the created or updated matrix dimension.|