Add attribute values

POST

/merchants/{merchantCode}/attributes/{attributeCode}/values

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

Add attribute values

Parameters

Path Parameters

merchantCode

required

string

attributeCode

required

string

Query Parameters

localeCode

string

Locale code to change the language of the attributes

Request Body

Media typeapplication/json

object

values

Array

object

code

required

Unique identifier for the attribute value

string

Example

black

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",
  "code": "rabbit",
  "sequenceId": 3
}

Responses

201

Successfully created

Media typeapplication/json

400

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"
    }
  ]
}

404

Merchant or attribute not found

Media typeapplication/json

default

Unexpected error

Media typeapplication/json

object

code

Machine readable error code

string

message

required

Human readable error code

string

Example^generated

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