Skip to content

updateStoreCatalogItems - Update Store Catalog Items for a given channel

Request

Description

Updates the store catalog items for a specific channel with the provided product IDs.

Behavior:

  • If the specified store does not exist in Mirakl Connect, a 404 error is returned.
  • This is an asynchronous operation - the request is accepted and processed in the background.
  • Products that do not exist in Mirakl Connect are silently ignored (no error returned when the request is accepted).
  • Successfully matched products will be updated regardless of unmatched products in the same request.
Call Frequency
Maximum usage: 30 per second
Security
Bearer(Required scopes:
connect-channel-platform:store-c...
)
Path
channel_idstring, non-emptyrequired

Connect Channel identifier

store_idstring, non-emptyrequireddeprecated

Store identifier in the channel

Bodyapplication/json; charset=UTF-8required
store_catalog_itemsArray of objects, [ 1 .. 10000 ] itemsrequired
curl -i -X POST \
  'https://miraklconnect.com/api/channel-platform/v1/channel-catalog/{channel_id}/store-catalog-items/{store_id}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -d '{
    "store_catalog_items": [
      {
        "id": "string",
        "diagnostics": [
          {
            "message": "string",
            "severity": "ERROR",
            "channel_diagnostic_id": "string",
            "channel_attribute_id": "string",
            "connector_override_action": "REMOVED"
          }
        ],
        "offer_diagnostics": [
          {
            "message": "string",
            "severity": "ERROR",
            "channel_diagnostic_id": "string",
            "channel_attribute_id": "string",
            "connector_override_action": "REMOVED"
          }
        ],
        "product_diagnostics": [
          {
            "message": "string",
            "severity": "ERROR",
            "channel_diagnostic_id": "string",
            "channel_attribute_id": "string",
            "connector_override_action": "REMOVED"
          }
        ],
        "offer_status": "OFFER_ACTIVE",
        "product_status": "PRODUCT_DOES_NOT_EXIST"
      }
    ]
  }'

Responses

Request accepted for processing.

The store catalog items update has been queued and will be processed asynchronously. Non-existent products will be silently ignored during processing.