Update/create a family

PATCH

/api/rest/v1/families/{code}

Family

This endpoint allows you to update a given family. Know more about Update behavior. Note that if no family exists for the given code, it creates it.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/api/rest/v1/families/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "attribute_as_image": "picture",
    "attribute_as_label": "name",
    "attribute_requirements": {
        "ecommerce": [
            "sku",
            "name",
            "description",
            "price",
            "color"
        ],
        "tablet": [
            "sku",
            "name",
            "description",
            "price"
        ]
    },
    "attributes": [
        "sku",
        "name",
        "description",
        "price",
        "color",
        "picture"
    ],
    "code": "caps",
    "labels": {
        "en_US": "Caps",
        "fr_FR": "Casquettes"
    }
}'

Response Example

201 - Example 1

{}

Request

Path Params

code

string

required

Code of the resource

Body Params application/json

attribute_as_image

string

optional

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

Default:

null

attribute_as_label

string

required

Attribute code used as label

attribute_requirements

object

optional

Attributes codes of the family that are required for the completeness calculation for each channel

channelCode

array[string]

optional

attributes

array[string]

optional

Attributes codes that compose the family

code

string

required

Family code

labels

object

optional

Family labels for each locale

Default:

{}

localeCode

string

optional

Family label for the locale localeCode

Examples

Responses

🟢201Created

application/json

Body

object {0}

🟢204No content to return

🟠400Bad request

🟠401Authentication required

🟠403Access forbidden

🟠415Unsupported Media type

🟠422Unprocessable entity

Modified at 2023-08-15 05:53:55

Get a family

Create a new family variant