UpdateProducts3

Pushes new or updated product and collections data to Bubblehouse.

This API supports multiple ways to specify product-collection associations:

1. Preferred approach: Send products with collection_ids field and collections without product information. This gives you explicit control over which collections each product belongs to.
2. Send products with collections array - useful when you want to create/update collections while associating products.
3. Send products without collection data, and send collections with product_ids field - useful when managing collections and want to specify their members.
4. Send collections with products array - useful when creating/updating products and collections together.

When updating both products and collections in a single call, collection updates are processed before product updates.

This func will not return an error unless the incoming data is wildly syntactically incorrect. The actual processing may be delayed until a later time, and the errors might only be visible via error emails later. Use debug option to receive more errors immediately during development.

You should decide if you're sending collection memberships within products or within collections. Please do not send the same membership information in both places.

When pushing multiple updates, Bubblehouse will process all of them, even if some fail. This means that, if this function returns 200 OK or 4xx, you should not retry pushing the same data. If the call results in 5xx or a network error, though, retry all of them. (It is always safe to push the same updates multiple times; would be just like a no-op update.)

There is no separate deletion call, but you can delete products and collection by updating with "deleted": true flag.

Input

Output

A successful response has no meaningful properties and only contains an ok property always set to true:

{"ok": true}

Specific Errors

API-wide Errors

Global Errors