v2 > Services > MaterialsUpdate

Update one or more materials in Origin.

• URL

  /connect/v2/materials/update

  /connect/v2/async/materials/update

• Method:

  POST

• URL Params

  none

• Request :

• Sample Request (Update of materials attributes):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "productId": "MY-MAT-001",
            "managementPermission": "ONLY_ME",
            "name": "My material",
            "description": "a new material description",
            "url": "https://public.facing.url/mynewmaterial.html"
        }
    ]
}

• Sample Request (Update of brand):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "brand": {
                "name": "ACME new brand.",
                "website": "www.acmenewxyz.com"
            }
        }
    ]
}

• Sample Request (Update of category with category code):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "category": {
                "code": "gc_22"
            }
        }
    ]
}

• Sample Request (Update of category with category name):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "category": {
                "name": "Doors"
            }
        }
    ]
}

• Sample Request (Update of logoUrl):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "logoUrl": {
                "originalUrl": "https://public.facing.url/newlogo.jpg"
            }
        }
    ]
}

• Sample Request (Update of collection):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "collection": {
                "name": "Summer Collection"
            }
        }
    ]
}

• Sample Request (Update the material by ADDING a library):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "libraries": [
                {
                    "collectionBehavior": "ADD",
                    "name": "My new Library"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by REMOVING a library):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "libraries": [
                {
                    "collectionBehavior": "REMOVE",
                    "name": "My Acme Library"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by ADDING a CSI division):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "csiDivisions": [
                {
                    "collectionBehavior": "ADD",
                    "code": "126800",
                    "name": "Seat and Table Assemblies"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by REMOVING a CSI division):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "csiDivisions": [
                {
                    "collectionBehavior": "REMOVE",
                    "code": "126800"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by ADDING an image):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "images": [
                {
                    "collectionBehavior": "ADD",
                    "originalUrl": "https://public.facing.url/image2.jpg"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by REMOVING an image):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "images": [
                {
                    "collectionBehavior": "REMOVE",
                    "originalUrl": "https://public.facing.url/image2.jpg"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by ADDING a document):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "additionalsDocuments": [
                {
                    "collectionBehavior": "ADD",
                    "originalUrl": "https://public.facing.url/document.doc"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by REMOVING a document):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "additionalsDocuments": [
                {
                    "collectionBehavior": "REMOVE",
                    "originalUrl": "https://public.facing.url/document.doc"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by ADDING a contact):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "contacts": [
                {
                    "collectionBehavior": "ADD",
                    "externalId": "JOHNSMITHAUDITOR1",
                    "type": "AUDITOR",
                    "companyName": "ACME Inc.",
                    "name": "John Smith",
                    "website": "https://www.acme.com/",
                    "postalAddress": "2500 Street Avenues",
                    "phone": "1-999-123-1234",
                    "email": "auditsrep@acme.com"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by UPDATING a contact website):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "contacts": [
                {
                    "collectionBehavior": "ADD",
                    "externalId": "JOHNSMITHAUDITOR1",
                    "website": "https://www.acme-2000.com/"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by REMOVING a contact):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "contacts": [
                {
                    "collectionBehavior": "REMOVE",
                    "externalId": "JOHNSMITHAUDITOR1"
                }
            ]
        }
    ]
}

• Sample Request (Update the material visibility. ADD channel = PUBLISH on that channel):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "channels": [
                {
                    "collectionBehavior": "ADD",
                    "name": "ORIGIN"
                }
            ]
        }
    ]
}

• Sample Request (Update the material visibility. REMOVE channel = UNPUBLISH from that channel):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "channels": [
                {
                    "collectionBehavior": "REMOVE",
                    "name": "ORIGIN"
                }
            ]
        }
    ]
}

• Sample Request (Save the material to the company library. ADD channel = SAVE TO that channel):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "channels": [
                {
                    "collectionBehavior": "ADD",
                    "name": "COMPANY_LIBRARY"
                }
            ]
        }
    ]
}

• Sample Request (Remove the material from th company library. REMOVE channel = REMOVE FROM that channel):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "channels": [
                {
                    "collectionBehavior": "REMOVE",
                    "name": "COMPANY_LIBRARY"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by ADDING a custom feature):

Note : If the feature already exist, nothing happen.

{
  "materials":[
    {
      "locale":"en",
      "originId":"88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
      "featuresCustoms":[
        {
          "collectionBehavior":"ADD",
          "code":"CUSTOM_TEXT_ATTRIBUTE",
          "name":"Supported temperature",
          "value":{
            "content":"1550C"
          }
        }
      ]
    }
  ]
}

• Sample Request (Update the material by UPDATING a custom feature) New and Recommanded way with originId:

Note : To update a custom feature, the custom feature code and originId must be identical to those returned by the MaterialsSearch to be updated

{
  "materials":[
    {
      "locale":"en",
      "originId":"88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
      "featuresCustoms":[
        {
          "collectionBehavior":"ADD",
          "originId": "1aaaf230-1fb4-4213-9b26-dd7c4489bea6",
          "code":"CUSTOM_TEXT_ATTRIBUTE",
          "name":"Supported temperature",
          "value":{
            "content":"2000C"
          }
        }
      ]
    }
  ]
}

• Sample Request (Update the material by UPDATING a custom feature) Old and Not Recommanded way:

Note : To update a custom feature, you must delete the old custom feature and add the new custom feature. The old custom feature payload must be identical to the payload returned by the MaterialsSearch to be removed

{
  "materials":[
    {
      "locale":"en",
      "originId":"88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
      "featuresCustoms":[
        {
          "collectionBehavior":"REMOVE",
          "code":"CUSTOM_TEXT_ATTRIBUTE",
          "name":"Supported temperature",
          "value":{
            "content":"1550C"
          }
        },
        {
          "collectionBehavior":"ADD",
          "code":"CUSTOM_TEXT_ATTRIBUTE",
          "name":"Supported temperature",
          "value":{
            "content":"2000C"
          }
        }
      ]
    }
  ]
}

• Sample Request (Update the material by REMOVING a custom feature.) New and Recommanded way with originId:

Note : If the feature does not exist, nothing happen. The custom feature code and originId must be identical to those returned by the MaterialsSearch to be removed

{
  "materials":[
    {
      "locale":"en",
      "originId":"88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
      "featuresCustoms":[
        {
          "collectionBehavior":"REMOVE",
          "originId": "1aaaf230-1fb4-4213-9b26-dd7c4489bea6",
          "code":"CUSTOM_TEXT_ATTRIBUTE",
          "name":"Supported temperature",
          "value":{
            "content":"1550C"
          }
        }
      ]
    }
  ]
}

• Sample Request (Update the material by REMOVING a custom feature.) Old and Not Recommanded way:

Note : If the feature does not exist, nothing happen. The custom feature payload must be identical to the payload returned by the MaterialsSearch to be removed

{
  "materials":[
    {
      "locale":"en",
      "originId":"88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
      "featuresCustoms":[
        {
          "collectionBehavior":"REMOVE",
          "code":"CUSTOM_TEXT_ATTRIBUTE",
          "name":"Supported temperature",
          "value":{
            "content":"1550C"
          }
        }
      ]
    }
  ]
}

• Sample Request (Update the material by ADDING a property feature):

Note : If the feature already exist, nothing happen.

{
  "materials":[
    {
      "locale":"en",
      "originId":"88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
      "featuresProperties":[
        {
          "collectionBehavior":"ADD",
          "code":"LENGTH",
          "value":{
            "content":"60"
          },
          "unit":{
            "code":"CENTIMETER"
          }
        }
      ]
    }
  ]
}

• Sample Request (Update the material by UPDATING a property feature) New and Recommanded way with originId:

Note : To update a property feature, the property feature code and originId must be identical to those returned by the MaterialsSearch to be updated.

{
  "materials":[
    {
      "locale":"en",
      "originId":"88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
      "featuresProperties":[
        {
          "collectionBehavior":"ADD",
          "originId":"f90d751d-c7ad-48b4-932b-6b1ce80469e8",
          "code":"LENGTH",
          "value":{
            "content":"24"
          },
          "unit":{
            "code":"INCH"
          }
        }
      ]
    }
  ]
}

• Sample Request (Update the material by UPDATING a property feature) Old and Not Recommanded way:

Note : To update a property feature, you must delete the old property feature and add the new property feature. The old property feature payload must be identical to the payload returned by the MaterialsSearch to be removed.

{
  "materials":[
    {
      "locale":"en",
      "originId":"88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
      "featuresProperties":[
        {
          "collectionBehavior":"REMOVE",
          "code":"LENGTH",
          "value":{
            "content":"60"
          },
          "unit":{
            "code":"CENTIMETER"
          }
        },
        {
          "collectionBehavior":"ADD",
          "code":"LENGTH",
          "value":{
            "content":"24"
          },
          "unit":{
            "code":"INCH"
          }
        }
      ]
    }
  ]
}

• Sample Request (Update the material by REMOVING a property feature) New and Recommanded way with originId:

Note : If the feature does not exist, nothing happen. The property feature code and originId must be identical to those returned by the MaterialsSearch to be removed

{
  "materials":[
    {
      "locale":"en",
      "originId":"88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
      "featuresProperties":[
        {
          "collectionBehavior":"REMOVE",
          "originId":"f90d751d-c7ad-48b4-932b-6b1ce80469e8",
          "code":"LENGTH",
          "value":{
            "content":"60"
          },
          "unit":{
            "code":"CENTIMETER"
          }
        }
      ]
    }
  ]
}

• Sample Request (Update the material by REMOVING a property feature) Old and Not Recommanded way:

Note : If the feature does not exist, nothing happen. The property feature payload must be identical to the payload returned by the MaterialsSearch to be removed.

{
  "materials":[
    {
      "locale":"en",
      "originId":"88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
      "featuresProperties":[
        {
          "collectionBehavior":"REMOVE",
          "code":"LENGTH",
          "value":{
            "content":"60"
          },
          "unit":{
            "code":"CENTIMETER"
          }
        }
      ]
    }
  ]
}

• For more sample requests related to features, please see the Advanced Guidelines Multilingual Material Features

• Sample Request (Update the material by ADDING a tag):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "tags": [
                {
                    "collectionBehavior": "ADD",
                    "name": "modern"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by REMOVING a tag):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "tags": [
                {
                    "collectionBehavior": "REMOVE",
                    "name": "modern"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by ADDING a SKU):

{
  "materials":[
    {
      "locale":"en",
      "originId":"88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
      "skus":[
        {
          "collectionBehavior":"ADD",
          "name":"New sku",
          "productId":"SKU-A01",
          "images":[
            {
              "collectionBehavior":"ADD",
              "originalUrl":"https://public.facing.url/001.jpg"
            }
          ],
          "additionalsDocuments":[
            {
              "collectionBehavior":"ADD",
              "originalUrl":"https://public.facing.url/001.pdf"
            }
          ],
          "featuresCustoms":[
            {
              "collectionBehavior":"ADD",
              "code":"CUSTOM_TEXT_ATTRIBUTE",
              "name":"Supported temperature",
              "value":{
                "content":"1550C"
              }
            }
          ],
          "featuresProperties":[
            {
              "collectionBehavior":"ADD",
              "code":"LENGTH",
              "value":{
                "content":"60"
              },
              "unit":{
                "code":"CENTIMETER"
              }
            }
          ]
        }
      ]
    }
  ]
}

• Sample Request (Update the material by UPDATING a SKU name and productId) New and Recommanded way with originId:

{
  "materials":[
    {
      "locale":"en",
      "originId":"88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
      "skus":[
        {
          "collectionBehavior":"ADD",
          "originId":"cf020a53-f766-4320-949a-9173d3816a3a",
          "name":"New sku updated",
          "productId":"SKU-A01-UPDATED",
        }
      ]
    }
  ]
}

• Sample Request (Update the material by REMOVING custom feature and property feature of a SKU) New and Recommanded way with originId:

{
  "materials":[
    {
      "locale":"en",
      "originId":"88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
      "skus":[
        {
          "collectionBehavior":"ADD",
          "originId":"cf020a53-f766-4320-949a-9173d3816a3a",
          "name":"New sku",
          "productId":"SKU-A01",
          "featuresCustoms":[
            {
              "collectionBehavior":"REMOVE",
              "originId":"4097a9a1-8ccb-4e1b-b609-2cdf10fccf2e",
              "code":"CUSTOM_TEXT_ATTRIBUTE",
              "name":"Supported temperature",
              "value":{
                "content":"1550C"
              }
            }
          ],
          "featuresProperties":[
            {
              "collectionBehavior":"REMOVE",
              "originId":"5b3119a7-e9fc-4a84-9f4e-157eedf11e4e",
              "code":"LENGTH",
              "value":{
                "content":"60"
              },
              "unit":{
                "code":"CENTIMETER"
              }
            }
          ]
        }
      ]
    }
  ]
}

• Sample Request (Update the material by REMOVING custom feature and property feature of a SKU )Old and Not Recommanded way:

{
  "materials":[
    {
      "locale":"en",
      "originId":"88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
      "skus":[
        {
          "collectionBehavior":"ADD",
          "name":"New sku",
          "productId":"SKU-A01",
          "featuresCustoms":[
            {
              "collectionBehavior":"REMOVE",
              "code":"CUSTOM_TEXT_ATTRIBUTE",
              "name":"Supported temperature",
              "value":{
                "content":"1550C"
              }
            }
          ],
          "featuresProperties":[
            {
              "collectionBehavior":"REMOVE",
              "code":"LENGTH",
              "value":{
                "content":"60"
              },
              "unit":{
                "code":"CENTIMETER"
              }
            }
          ]
        }
      ]
    }
  ]
}

• Sample Request (Update the material by REMOVING a SKU) New and Recommanded way with originId:

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "skus": [
                {
                    "collectionBehavior": "REMOVE",
                    "originId":"cf020a53-f766-4320-949a-9173d3816a3a",
                    "name": "New sku"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by REMOVING a SKU) Old and Not Recommanded way:

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "skus": [
                {
                    "collectionBehavior": "REMOVE",
                    "name": "New sku"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by ADDING a connecting certification):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "connectedCertifications": [
                {
                    "collectionBehavior": "ADD",
                    "originId": "f6f2c73e-4054-44bc-95f2-9e033b9c2282"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by REMOVING a connecting certification):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "connectedCertifications": [
                {
                    "collectionBehavior": "REMOVE",
                    "originId": "f6f2c73e-4054-44bc-95f2-9e033b9c2282"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by ADDING a connecting declaration):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "connectedDeclarations": [
                {
                    "collectionBehavior": "ADD",
                    "originId": "ca3dcfc2-c8b6-4348-93ff-1f7a0cd84350"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by REMOVING a connecting declaration):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "connectedDeclarations": [
                {
                    "collectionBehavior": "REMOVE",
                    "originId": "ca3dcfc2-c8b6-4348-93ff-1f7a0cd84350"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by ADDING a connecting test report):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "connectedTestReports": [
                {
                    "collectionBehavior": "ADD",
                    "originId": "71d2b7cf-686a-4b9b-9385-2560777a6a71"
                }
            ]
        }
    ]
}

• Sample Request (Update the material by REMOVING a connecting test report):

{
    "materials": [
        {
            "locale": "en",
            "originId": "88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
            "connectedTestReports": [
                {
                    "collectionBehavior": "REMOVE",
                    "originId": "71d2b7cf-686a-4b9b-9385-2560777a6a71"
                }
            ]
        }
    ]
}

• Sample Request (All fields):

{
  "materials":[
    {
      "locale":"en",
      "originId":"88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
      "productId":"MY-MAT-001",
      "managementPermission":"COMPANY_EDITABLE",
      "name":"My material",
      "description":"a new material description",
      "brand":{
        "name":"ACME Super brand.",
        "website":"www.acmesuperxyz.com"
      },
      "logoUrl":{
        "originalUrl":"https://public.facing.url/newlogo.jpg"
      },
      "collection":{
        "name":"Spring Collection"
      },
      "libraries":[
        {
          "collectionBehavior":"ADD",
          "name":"My Acme Library"
        }
      ],
      "category":{
        "name":"Tables"
      },
      "csiDivisions":[
        {
          "collectionBehavior":"ADD",
          "code":"126800",
          "name":"Seat and Table Assemblies"
        }
      ],
      "images":[
        {
          "collectionBehavior":"ADD",
          "originalUrl":"https://public.facing.url/image2.jpg"
        }
      ],
      "additionalsDocuments":[
        {
          "collectionBehavior":"ADD",
          "originalUrl":"https://public.facing.url/document.doc"
        }
      ],
      "contacts":[
        {
          "collectionBehavior":"ADD",
          "externalId":"JOHNSMITHAUDITOR1",
          "type":"AUDITOR",
          "companyName":"ACME Inc.",
          "name":"John Smith",
          "website":"https://www.acme.com/",
          "postalAddress":"2500 Street Avenues",
          "phone":"1-999-123-1234",
          "email":"auditsrep@acme.com"
        }
      ],
      "channels":[
        {
          "collectionBehavior":"ADD",
          "name":"ORIGIN"
        }
      ],
      "featuresCustoms":[
        {
          "collectionBehavior":"ADD",
          "code":"CUSTOM_TEXT_ATTRIBUTE",
          "name":"Supported temperature",
          "value":{
            "content":"1550C"
          }
        }
      ],
      "featuresProperties":[
        {
          "collectionBehavior":"ADD",
          "code":"LENGTH",
          "value":{
            "content":"60"
          },
          "unit":{
            "code":"CENTIMETER"
          }
        }
      ],
      "tags":[
        {
          "collectionBehavior":"ADD",
          "name":"modern"
        }
      ],
      "skus":[
        {
          "collectionBehavior":"ADD",
          "name":"New sku",
          "productId":"SKU-A01",
          "images":[
            {
              "collectionBehavior":"ADD",
              "originalUrl":"https://public.facing.url/001.jpg"
            }
          ],
          "additionalsDocuments":[
            {
              "collectionBehavior":"ADD",
              "originalUrl":"https://public.facing.url/001.pdf"
            }
          ],
          "featuresCustoms":[
            {
              "collectionBehavior":"ADD",
              "code":"CUSTOM_TEXT_ATTRIBUTE",
              "name":"Supported temperature",
              "value":{
                "content":"1550C"
              }
            }
          ],
          "featuresProperties":[
            {
              "collectionBehavior":"ADD",
              "code":"LENGTH",
              "value":{
                "content":"60"
              },
              "unit":{
                "code":"CENTIMETER"
              }
            }
          ]
        }
      ],
      "connectedCertifications":[
        {
          "collectionBehavior":"REMOVE",
          "originId":"f6f2c73e-4054-44bc-95f2-9e033b9c2282"
        }
      ],
      "url":"https://public.facing.url/mynewmaterial.html"
    }
  ]
}

• Response (sync mode) :

• Sample Response (Success in sync mode):

  HTTP Code : 200

{
    "status":{
        "state":"SUCCESS"
    },
    "result":{
        "entityType":"MATERIAL",
        "result":"Update completed."
    },
    "connectRequest":{
        "materials":[
            {
                "locale":"en",
                "originId":"88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
                "url":"https://public.facing.url/material"
            }
        ]
    }
}

• Response (async mode):

• Sample Response (Success in async mode):

  HTTP Code : 200

{
    "status":{
        "state":"SUCCESS"
    },
    "result":{
        "poolingCallback":"https://origin.build/equinox/connect/v2/result/materials_update/batch/1c8a06b6-45be-4e68-9e2d-5c1f075e6ca2"
    },
    "connectRequest":{
        "materials": [
            {
                "locale": "en",
                "originId":"88dada05-5d38-4b60-91b9-f1bf9d6bf5dd",
                "url":"https://public.facing.url/material"
            }
        ]
    }
}

• Sample Response (Error):

  HTTP Code : 400, 500

{
    "status": {
        "state": "ERROR",
        "code": "CE00001 - Connect request failed validation. Refer to provided messages for details.",
        "messages": [
            "materials[1] has invalid value 'eee' for field locale. Allowed value(s) : [de, es_MX, en, fr, zh_CN]",
            "materials[1] has invalid value 'Empty string' for field name. Allowed value(s) : [Non-empty string]",
            "materials[1] require one brand.name.",
            "materials[1] has invalid value 'COMPANY_WRITE' for field managementPermission. Allowed value(s) : [COMPANY_EDITABLE,COMPANY_READONLY,ONLY_ME]",
            "materials[1] require one originId or externalId.",
            "materials[1] has invalid value 'Empty string' for field productId. Allowed value(s) : [Non-empty string]",
            "materials[1] require one csiDivisions[1].code or csiDivisions[1].name.",
            "materials[1] has invalid value 'ADD_ITEM' for field libraries[1].collectionBehavior. Allowed value(s) : [ADD,REMOVE]",
            "materials[1] require one contacts[1].externalId.",
            "materials[1] require one skus[1].name.",
            "materials[1] require one logoUrl.originalUrl."
        ]
    },
    "connectRequest": {
        "materials": [
            {
                "locale": "eee",
                "productId": " ",
                "managementPermission": "COMPANY_WRITE",
                "name": "",
                "description": "a new material description",
                "brand": {
                    "website": "www.acmesuperxyz.com"
                },
                "logoUrl": {
                },
                "libraries": [
                    {
                        "collectionBehavior": "ADD_ITEM",
                        "name": "My Acme Library"
                    }
                ],
                "csiDivisions": [
                    {
                        "collectionBehavior": "ADD"
                    }
                ],
                "contacts": [
                    {
                        "collectionBehavior": "ADD",
                        "type": "AUDITOR",
                        "name": "John Smith",
                        "companyName": "ACME Inc.",
                        "website": "https://www.acme.com/",
                        "postalAddress": "2500 Street Avenues",
                        "phone": "1-999-123-1234",
                        "email": "auditsrep@acme.com"
                    }
                ],
                "skus": [
                    {
                        "collectionBehavior": "ADD",
                        "productId": "SKU-A01"
                    }
                ]
            }
        ]
    }
}