v1

latestSwagger 2.02026-07-13137761.0 MB

Asset

Update/create several assets

This endpoint allows you to update and/or create several assets of one given asset family at once. Learn more about the <a href="/documentation/update.html#patch-asset-attribute-values">Update behavior</a>. 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.

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

Path parameters

asset_family_codestring required

Code of the asset family

Request body

codestring required

Code of the asset

asset_family_codestring

Code of the asset family

valuesobject

Asset attributes values, see the <a href='/concepts/asset-manager.html#focus-on-the-asset-values'>Focus on the asset values</a> section for more details.

createdstring dateTime

Date of creation

updatedstring dateTime

Date of the last update

Example request

[
  {
    "code": "sku_54628_picture1",
    "values": {
      "media_preview": [
        {
          "locale": null,
          "channel": null,
          "data": "sku_54628_picture1.jpg"
        }
      ],
      "model_wears_size": [
        {
          "locale": null,
          "channel": null,
          "data": "s"
        }
      ],
      "photographer": [
        {
          "locale": null,
          "channel": null,
          "data": "ben_levy"
        }
      ],
      "main_colors": [
        {
          "locale": null,
          "channel": null,
          "data": [
            "red",
            "purple"
          ]
        }
      ],
      "end_of_use_date": [
        {
          "locale": null,
          "channel": null,
          "data": "02/03/2021"
        }
      ]
    },
    "created": "2021-05-31T09:23:34+00:00",
    "updated": "2021-05-31T09:23:34+00:00"
  },
  {
    "code": "sku_54628_picture2",
    "values": {
      "media_preview": [
        {
          "locale": null,
          "channel": null,
          "data": "sku_54628_picture2.jpg"
        }
      ],
      "model_wears_size": [
        {
          "locale": null,
          "channel": null,
          "data": "s"
        }
      ],
      "photographer": [
        {
          "locale": null,
          "channel": null,
          "data": "ben_levy"
        }
      ],
      "main_colors": [
        {
          "locale": null,
          "channel": null,
          "data": [
            "blue",
            "white"
          ]
        }
      ],
      "end_of_use_date": [
        {
          "locale": null,
          "channel": null,
          "data": "02/03/2021"
        }
      ]
    },
    "created": "2021-05-31T09:23:34+00:00",
    "updated": "2021-05-31T09:23:34+00:00"
  },
  {
    "code": "sku_54628_picture3",
    "values": {
      "media_preview": [
        {
          "locale": null,
          "channel": null,
          "data": "sku_54628_picture3.jpg"
        }
      ],
      "model_wears_size": [
        {
          "locale": null,
          "channel": null,
          "data": "s"
        }
      ],
      "photographer": [
        {
          "locale": null,
          "channel": null,
          "data": "ben_levy"
        }
      ],
      "main_colors": [
        {
          "locale": null,
          "channel": null,
          "data": [
            "purple"
          ]
        }
      ],
      "end_of_use_date": [
        {
          "locale": null,
          "channel": null,
          "data": "02/03/2021"
        }
      ]
    },
    "created": "2021-05-31T09:23:34+00:00",
    "updated": "2021-05-31T09:23:34+00:00"
  }
]

Response

codestring

Resource code

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