Use the PUT request to replace the current configuration of a search interface in its entirety. For example, the following PUT request replaces configuration of the search interface ALL:

PUT /gsadmin/v1/cloud/searchInterfaces/All

The new configuration of the search interface ALL must be included in the body of the PUT request.

The PUT method replaces a search interface in its entirety; it cannot replace parts of a search interface. To modify an existing search interface by importing new or modified attributes into it, use the PATCH method.

An error results if you attempt to PUT a search interface with a given name when no search interface with that name currently exists.

The following example illustrates one possible JSON configuration of the search interface ALL:

{
  "ecr:type": "search-interface",
  "crossFieldMatch": "always",
  "fields": [
    {
      "attribute": "product.id"
    },
    {
      "attribute": "product.sku"
    },
    {
      "attribute": "product.code"
    },
    {
      "attribute": "product.brand.name"
    },
    {
      "attribute": "product.category"
    },
    {
      "attribute": "product.name"
    },
    {
      "attribute": "product.long_desc"
    },
    {
      "attribute": "ecr:crossField"
    }
  ]
}