Update/create an asset

PATCH

/api/rest/v1/asset-families/{asset_family_code}/assets/{code}

Asset

This endpoint allows you to update a given asset of a given asset family. Learn more about the Update behavior. Note that if the asset does not already exist for the given asset family, it creates it. This endpoint is case sensitive on the asset family code.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/api/rest/v1/asset-families//assets/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "code": "sku_54628_picture1",
    "created": "2023-08-15T05:53:50.699Z",
    "updated": "2023-08-15T05:53:50.699Z",
    "values": {
        "end_of_use_date": [
            {
                "channel": null,
                "data": "02/03/2021",
                "locale": null
            }
        ],
        "main_colors": [
            {
                "channel": null,
                "data": [
                    "red",
                    "purple"
                ],
                "locale": null
            }
        ],
        "media_preview": [
            {
                "channel": null,
                "data": "sku_54628_picture1.jpg",
                "locale": null
            }
        ],
        "model_wears_size": [
            {
                "channel": null,
                "data": "s",
                "locale": null
            }
        ],
        "photographer": [
            {
                "channel": null,
                "data": "ben_levy",
                "locale": null
            }
        ]
    }
}'

Response Example

201 - Example 1

{}

Request

Path Params

asset_family_code

string

required

Code of the asset family

code

string

required

Code of the resource

Body Params application/json

code

string

required

Code of the asset

created

string <dateTime>

optional

Date of creation

updated

string <dateTime>

optional

Date of the last update

values

object

optional

Asset attributes values, see the Focus on the asset values section for more details.

attributeCode

array [object {3}]

optional

Examples

Responses

🟢201Created

application/json

Body

object {0}

🟢204No content to return

🟠400Bad request

🟠401Authentication required

🟠415Unsupported Media type

🟠422Unprocessable entity

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

Get an asset of a given asset family

Get the list of attributes of a given asset family