Update/create several assets

PATCH

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

Asset

This endpoint allows you to update and/or create several assets of one given asset family at once. 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
                }
            ]
        }
    },
    {
        "code": "sku_54628_picture2",
        "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": [
                        "blue",
                        "white"
                    ],
                    "locale": null
                }
            ],
            "media_preview": [
                {
                    "channel": null,
                    "data": "sku_54628_picture2.jpg",
                    "locale": null
                }
            ],
            "model_wears_size": [
                {
                    "channel": null,
                    "data": "s",
                    "locale": null
                }
            ],
            "photographer": [
                {
                    "channel": null,
                    "data": "ben_levy",
                    "locale": null
                }
            ]
        }
    },
    {
        "code": "sku_54628_picture3",
        "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": [
                        "purple"
                    ],
                    "locale": null
                }
            ],
            "media_preview": [
                {
                    "channel": null,
                    "data": "sku_54628_picture3.jpg",
                    "locale": null
                }
            ],
            "model_wears_size": [
                {
                    "channel": null,
                    "data": "s",
                    "locale": null
                }
            ],
            "photographer": [
                {
                    "channel": null,
                    "data": "ben_levy",
                    "locale": null
                }
            ]
        }
    }
]'

Response Example

200 - Example 1

[
  {
    "code": "string",
    "message": "string",
    "status_code": 0
  }
]

Request

Path Params

asset_family_code

string

required

Code of the asset family

Body Params application/json

array of:

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

🟢200OK

application/json

Body

array of:

code

string

optional

Resource code

message

string

optional

Message explaining the error

status_code

integer

optional

HTTP status code, see Client errors to understand the meaning of each code

🟠400Bad request

🟠401Authentication required

🟠413Request Entity Too Large

🟠415Unsupported Media type

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

Get the list of the assets of a given asset family

Delete an asset