Use this API to update one or more existing product attributes in bulk. You can modify the attribute name, data type, and default value without recreating the attribute.

Each attribute is identified using its code. These fields determine which attribute to update and cannot be modified.

You can update up to 100 attributes per request. This batch limit is controlled by the CONF_PRODUCT_CREATE_UPDATE_BATCH_SIZE configuration.

What you can update

• name
• type
• defaultValueId

The API updates only the fields you provide in the request. Omitted fields remain unchanged.

What you cannot update

• code (immutable identifier)
• ouCode (scope cannot be changed after creation)

To change the attribute scope (org-level vs OU-level), create a new attribute with the correct configuration.

Default and validation behaviour

• If the provided defaultValueId does not exist, the API returns warning code 10210 and updates the attribute without setting a default value.
• If the attribute does not exist, the API returns error 10212.
• If some records succeed and others fail, the response reflects partial success using summary counts.

Organisation unit (OU) behaviour

• If ouCode is provided, the API updates the OU-scoped attribute.
• If ouCode is not provided, the API updates the organisation-level attribute (ouId = -1).
• The OU scope of an attribute cannot be changed using this API.

Example request

curl --location --request PUT 'https://{Host}/v2/product/attributes' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic a3Jpc2huYS50aWxsMDE6MDc1Yjk2NGIwNzE1MmQyMzRiNzA=' \
--data '[
    {
        "code": "v2_demo_17",
        "name": "v2_demo_17",
        "type": "Int"
    }
]'

curl --location --request PUT 'https://{host}/v2/product/attributes' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic a3Jpc2huYS50aWxsMDE6YzU5MDc1Yjk2NGIwNzE1MmQyMzRiNzA=' \
--data '[
     {
      "code": "warranty_years",
      "name": "Warranty Duration (Years)",
      "type": "Int"
      
    },
    {
      "code": "is_refurbished",
      "name": "Refurbished Product",
      "type": "Boolean"
      
    }

]'

Prerequisites

• Access Group: WRITE access to Product resource
• Authorization: Basic or OAuth token

Body parameters

The request body should be a JSON array of attribute objects.

API Quick Reference

{{PUT /v2/product/attributes}}
   └─ {{RequestBody}} (Batch Array)
      ├─ {{code}} (string)
      ├─ {{name}} (string)
      ├─ {{type}} (string)
      ├─ {{ouCode}} (string)
      ├─ {{defaultValueId}} (long)
      └─ {{ResponseBody}}
          ├─ {{updated}} []
          │   ├─ {{id}} (long)
          │   └─ {{code}} (string)
          ├─ {{summary}}
          │   ├─ {{totalRequested}} (integer)
          │   ├─ {{successCount}} (integer)
          │   └─ {{failureCount}} (integer)
          ├─ {{warnings}} []
          └─ {{errors}} []

Example response

{
    "updated": [
        {
            "id": 91444,
            "ouId": -1,
            "code": "v2_demo_17"
        }
    ],
    "summary": {
        "totalRequested": 1,
        "successCount": 1,
        "failureCount": 0
    },
    "warnings": [],
    "errors": []
}

Response parameters

Error codes

Warning codes