Sign in

v1

latestSwagger 2.02026-07-13137761.0 MB
Family

Update/create several families

This endpoint allows you to update and/or create several families at once.

patch/api/rest/v1/families

Request body

codestring required

Family code

attribute_as_labelstring required

Attribute code used as label

attribute_as_imagestring

Attribute code used as the main picture in the user interface (only since v2.0)

attributesstring[]

Attributes codes that compose the family

Example request

{
  "code": "caps",
  "attributes": [
    "sku",
    "name",
    "description",
    "price",
    "color",
    "picture"
  ],
  "attribute_as_label": "name",
  "attribute_as_image": "picture",
  "attribute_requirements": {
    "ecommerce": [
      "sku",
      "name",
      "description",
      "price",
      "color"
    ],
    "tablet": [
      "sku",
      "name",
      "description",
      "price"
    ]
  },
  "labels": {
    "en_US": "Caps",
    "fr_FR": "Casquettes"
  }
}

Response

OK

lineinteger

Line number

identifierstring

Resource identifier, only filled when the resource is a product

codestring

Resource code, only filled when the resource is not a product

status_codeinteger

HTTP status code, see <a href="/documentation/responses.html#client-errors">Client errors</a> to understand the meaning of each code

messagestring

Message explaining the error