EAeagleeye
Product Inventory

Bulk Update Inventory Products (BETA)

This API endpoint allows the calling unit to update multiple inventory products for their child unit as specified by its incomingIdentifier. The request body must be a non-empty array of up to 100 products. The endpoint returns 200 when all requested products are updated, 207 when update is partially successful, and 400 when all requested products fail or the request payload does not satisfy schema validation.

put/products/{incomingIdentifier}/bulk

Request

  • Base URL
    https://resources.uk.eagleeye.com
  • URL
    https://resources.uk.eagleeye.com/products/{incomingIdentifier}/bulk
  • Auth
    none declared. Required headers: X-EES-AUTH-CLIENT-ID, X-EES-AUTH-HASH

Path parameters

incomingIdentifierstring string required

The incoming identifier of the unit whose inventory products and groups are being managed.

Headers

Accept-Encoding'''' | ''gzip'' | ''deflate'' | ''gzip,deflate'' | ''deflate,gzip'' string

This request HTTP header advertises which content encoding (usually a compression algorithm) the calling application is able to understand. The server selects one of the proposals, use it and informs the client of its choice with the Content-Encoding Response header. Currently supported gzip and deflate. Please note if this request header is not present, no compression will be used.

Connection'keep-alive' | 'close' string

This general HTTP header controls (or rather influences) whether the network connection stays open after the current request finishes. If the sent value is keep-alive, the connection should stay in a special state, allowing to be reused for subsequent requests to the same server. Please note these connections will be closed after reaching timeout threshold controlled by EES server (usually after 5 seconds).

Content-Typestring string

Standard HTTP header to inform EES API what type of content was passed in request payload

X-EES-AUTH-CLIENT-IDstring string required

Client ID, This will be provided by EES and is unique to the company calling the API.

X-EES-AUTH-HASHstring string required

Request Security Hash, calculated using SHA-256 function from concatenated full Request URI Path with Query String(s), Payload and Client Secret.

X-EES-TRANSACTION-IDstring string

Unique Reference for the API transaction within the calling company.

Request body

idstring required

The unique identifier of the inventory product.

groupIdstring required

The identifier of the group this product belongs to.

namestring

The display name of the product.

descriptionstring

An optional description of the product.

imageUrlstring nullable

URL of the product image.

supplierIdstring

The identifier of the product supplier.

supplierNamestring

The display name of the product supplier.

brandstring

The brand of the product.

brandTypestring

The brand type classification of the product.

lastSoldDatestring ees-date-time nullable

The date and time the product was last sold (ISO 8601 / ATOM format).

tagsstring[]

A list of tags associated with the product.

Example request

[
  {
    "id": "APPLE_001",
    "groupId": "FRUIT",
    "name": "Pink Lady Apple 500g",
    "description": "Sweet, crunchy Pink Lady apples.",
    "imageUrl": "https://cdn.example.com/products/pink-lady-apple-500g.jpg",
    "supplierId": "fresh-orchard-co",
    "supplierName": "Fresh Orchard & Co.",
    "brand": "Orchard Select",
    "brandType": "own-label",
    "lastSoldDate": "2026-03-04T15:21:33+00:00",
    "tags": [
      "Fresh Produce",
      "Seasonal"
    ]
  }
]

Response

All requested products were updated successfully.

Example response

{
  "successful": {
    "total": 1,
    "results": [
      {
        "id": "APPLE_001",
        "groupId": "FRUIT",
        "name": "Pink Lady Apple 500g",
        "description": "Sweet, crunchy Pink Lady apples.",
        "imageUrl": "https://cdn.example.com/products/pink-lady-apple-500g.jpg",
        "supplierId": "fresh-orchard-co",
        "supplierName": "Fresh Orchard & Co.",
        "brand": "Orchard Select",
        "brandType": "own-label",
        "lastSoldDate": "2026-03-04T15:21:33+00:00",
        "tags": [
          "Fresh Produce",
          "Seasonal"
        ],
        "group": {
          "id": "FRUIT",
          "name": "Fruit",
          "type": "category",
          "description": "My group",
          "parentId": "GROCERY"
        }
      }
    ]
  },
  "failed": {
    "total": 1,
    "results": [
      {
        "id": "missing-product-123",
        "errorCode": "IR",
        "errorMessage": "Invalid request data"
      }
    ]
  }
}

Changes