v1

latestSwagger 2.02026-07-13137761.0 MB

Reference entity record

Update/create several reference entity records

This endpoint allows you to update and/or create several records of one given reference entity at once. Learn more about <a href="/documentation/update.html#patch-reference-entity-record-values">Update behavior</a>. Note that if the record does not already exist for the given reference entity, it creates it.

patch/api/rest/v1/reference-entities/{reference_entity_code}/records

Path parameters

reference_entity_codestring required

Code of the reference entity

Request body

codestring required

Code of the record

valuesobject

Record attributes values, see <a href='/concepts/reference-entities.html#focus-on-the-reference-entity-record-values'>Reference entity record values</a> section for more details

createdstring dateTime

Date of creation.

updatedstring dateTime

Date of the last update.

Example request

[
  {
    "code": "kartell",
    "values": {
      "label": [
        {
          "locale": "en_US",
          "channel": null,
          "data": "Kartell"
        }
      ],
      "image": [
        {
          "locale": null,
          "channel": null,
          "data": "0/c/b/0/0cb0c0e115dedba676f8d1ad8343ec207ab54c7b_image.jpg"
        }
      ],
      "description": [
        {
          "locale": "en_US",
          "channel": null,
          "data": "Kartell, the Italian furniture company that sells modern and remarkable pieces of furnitures."
        },
        {
          "locale": "fr_FR",
          "channel": null,
          "data": "Kartell, l'éditeur de meuble italien spécialisé dans la signature de belle pièces au design contemporain."
        }
      ],
      "country": [
        {
          "locale": null,
          "channel": null,
          "data": "italy"
        }
      ],
      "collection_overview": [
        {
          "locale": null,
          "channel": null,
          "data": "5/1/d/8/51d81dc778ba1501a8f998f3ab5797569f3b9e25_img.png"
        }
      ],
      "creation_year": [
        {
          "locale": null,
          "channel": null,
          "data": "1949"
        }
      ]
    }
  },
  {
    "code": "ligneroset",
    "values": {
      "label": [
        {
          "locale": "en_US",
          "channel": null,
          "data": "Ligne Roset"
        }
      ],
      "image": [
        {
          "locale": null,
          "channel": null,
          "data": "4/b/0/1/0cb0c0e115dedde78b8d1ad8343ec980cd5daa54_image.jpg"
        }
      ],
      "description": [
        {
          "data": "Very well known French brand of modern and luxury furniture",
          "locale": "en_US",
          "channel": null
        },
        {
          "data": "La marque renommée des meubles de luxe à la française",
          "locale": "fr_FR",
          "channel": null
        }
      ],
      "country": [
        {
          "locale": null,
          "channel": null,
          "data": "france"
        }
      ],
      "creation_year": [
        {
          "locale": null,
          "channel": null,
          "data": "1860"
        }
      ]
    }
  },
  {
    "code": "usm",
    "values": {
      "label": [
        {
          "locale": "en_US",
          "channel": null,
          "data": "USM"
        }
      ],
      "image": [
        {
          "locale": null,
          "channel": null,
          "data": "9/c/g/1/0cb0c0e115dedba76f8d1ad8343ec897abc43bv4_image.jpg"
        }
      ],
      "description": [
        {
          "data": "Modular furniture from Switzerland for your home and office",
          "locale": "en_US",
          "channel": null
        },
        {
          "data": "L'éditeur de meubles modulaires suisse pour votre intérieur et pour les entreprises",
          "locale": "fr_FR",
          "channel": null
        }
      ],
      "country": [
        {
          "locale": null,
          "channel": null,
          "data": "switzerland"
        }
      ],
      "creation_year": [
        {
          "locale": null,
          "channel": null,
          "data": "1885"
        }
      ]
    }
  }
]

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