Skip to content

Update attribute value

POST
/merchants/{merchantCode}/attributes/{attributeCode}/values/{attributeValueCode}
curl --request POST \
--url https://customer.shopgate.io/v1/merchants/example/attributes/example/values/example \
--header 'Content-Type: application/json' \
--data '{ "name": "Rabbit", "sequenceId": 3 }'

Update attribute value

merchantCode
required
string
attributeCode
required
string
attributeValueCode
required
string
localeCode
string

Locale code to change the language of the attributes

Media typeapplication/json
object
sequenceId
required

Sequence id of the order of the values. The lowest number is at the top and the highest number is at the bottom.

number
Example
0
name
required

Name of the attribute value which will be shown to the customer. It’s saved in the language of the passed locale.

string
Example
Black
Example
{
"name": "Rabbit",
"sequenceId": 3
}

Successfully updated

Media typeapplication/json

Validation error

Media typeapplication/json
object
errors
Array<object>
object
field
required

The parameter-field, that failed to validate, like “shopNumber”

string
value

The value, that was sent, like “xxx”

string
code
required

Machine readable error code

string
Allowed values: ENUM_MISMATCH MAXIMUM MAXIMUM_EXCLUSIVE MINIMUM MINIMUM_EXCLUSIVE MULTIPLE_OF ARRAY_LENGTH_LONG ARRAY_LENGTH_SHORT ARRAY_ADDITIONAL_ITEMS ARRAY_UNIQUE MAX_LENGTH MIN_LENGTH MAX_PROPERTIES MIN_PROPERTIES OBJECT_MISSING_REQUIRED_PROPERTY OBJECT_PROPERTIES_MAXIMUM OBJECT_PROPERTIES_MINIMUM OBJECT_ADDITIONAL_PROPERTIES OBJECT_DEPENDENCY_KEY ONE_OF_MISSING ONE_OF_MULTIPLE NOT_PASSED INVALID_FORMAT UNKNOWN_FORMAT PATTERN
message
required

Human readable error code

string
Example
{
"errors": [
{
"code": "ENUM_MISMATCH"
}
]
}

Merchant, attribute or attribute value not found

Media typeapplication/json

Unexpected error

Media typeapplication/json
object
code

Machine readable error code

string
message
required

Human readable error code

string
Examplegenerated
{
"code": "example",
"message": "example"
}