Update attributes

PATCH /attributes/. Required scopes: attributes:write.

PATCH /api/public/v1/attributes/{attribute_id}

Update attributes

cURL

curl --request PATCH \
  --url https://wisepim.com/api/public/v1/attributes/{attribute_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "<string>",
  "label": "<string>",
  "label_localized": {},
  "attribute_type": "<string>",
  "attribute_group": 1,
  "is_required": true,
  "is_unique": true,
  "is_filterable": true,
  "is_searchable": true,
  "is_visible": true,
  "is_localizable": true,
  "sort_order": 123,
  "default_value": "<unknown>",
  "validation_rules": {},
  "options": [
    "<unknown>"
  ],
  "operations": [
    "<string>"
  ],
  "ai_enrichable": true,
  "uom_code_set": 1,
  "value_code_set": 1,
  "default_unit_code": "<string>",
  "allow_new_options_on_import": true,
  "allow_new_options_from_ai": true
}
'

200

{
  "id": 123,
  "code": "<string>",
  "label": "<string>",
  "label_localized": {},
  "attribute_type": "<string>",
  "is_required": true,
  "is_unique": true,
  "is_filterable": true,
  "is_searchable": true,
  "is_visible": true,
  "group": {
    "id": 123,
    "name": "<string>"
  },
  "options": "<unknown>"
}

Authorizations

Authorization · string · header · required

Use a project API key from Settings > API Access. Send it as Authorization: Bearer wpk_.... See authentication and scopes for setup and permissions.

Headers

Idempotency-Key · string

Reuse this key for retries of the same write. Scoped to this API key; retained until key deletion. Different requests with the same key return 409.

Required string length: 1 - 128

Pattern: ^[!-~]+$

Path Parameters

attribute_id · integer · required

Body

application/json

code · string

Unique identifier for the attribute (e.g., cpu_type, screen_size)

Maximum string length: 50

label · string

Human-readable name for the attribute (e.g., CPU Type, Screen Size)

Maximum string length: 255

label_localized · Label Localized · object

Locale-keyed labels, e.g. {'en': 'Nominal voltage', 'de': 'Nennspannung'}. Classification standards ship a name per release language — label alone would pin the project to whichever locale it was materialised in.

Show child attributes

attribute_type · string

The type of data this attribute stores

Maximum string length: 20

attribute_group · integer | null

The group this attribute belongs to for UI organization

Required range: x > 0

is_required · boolean

Whether this attribute must have a value when used in a family

is_unique · boolean

Whether this attribute's value must be unique across products

is_filterable · boolean

Whether this attribute can be used for filtering products

is_searchable · boolean

Whether this attribute should be included in product searches

is_visible · boolean

Whether this attribute should be visible in the UI

is_localizable · boolean

Whether this attribute's values can be different per locale. Enable for text content (names, descriptions). Disable for universal values (SKUs, numbers, dates, colors).

sort_order · integer

Order in which this attribute should be displayed within its group

default_value · any | null

Default value for this attribute when assigned to a product

validation_rules · Validation Rules · object | null

Rules for validating attribute values

options · any[] Options · object

Predefined options for select/multiselect attributes

operations · string[]

List of enabled operations for this attribute (e.g., import, export, enrich)

ai_enrichable · boolean

Whether this attribute can be enriched using AI

uom_code_set · integer | null

Unit of measure code set for numeric/decimal attributes. Specifies which units are valid for this attribute's values.

Required range: x > 0

value_code_set · integer | null

Controlled vocabulary for select/multiselect attributes. If set, values must come from this code set. Takes precedence over the legacy 'options' JSONField.

Required range: x > 0

default_unit_code · string

Unit this attribute's values are expressed in (a code from uom_code_set). ETIM prescribes exactly one unit per feature; without it the editors show the whole unit set with nothing preselected.

Maximum string length: 20

allow_new_options_on_import · boolean

Allow creating new options for select/multiselect attributes during product import

allow_new_options_from_ai · boolean

Let AI enrichment add a new option when no existing select/multiselect option fits

Response

200

application/json

OK

id · integer · required

code · string · required

label · string · required

label_localized · Label Localized · object · required

attribute_type · string · required

is_required · boolean · required

is_unique · boolean · required

is_filterable · boolean · required

is_searchable · boolean · required

is_visible · boolean · required

group · GroupRefOut · object | null

Show child attributes

options · any

Predefined options for select/multiselect attributes.