The Unavailabilities Endpoint enables you to set items as "available" or "unavailable" to reflect their real-time stock status (e.g., items that are out of stock). Since stock availability can differ for every site, both the Catalogue ID (provided during catalogue upload) and the specific Site ID are required when using this endpoint.
When you first add items to a store through the Update Listings endpoint, all items are automatically set as "available" for customers to order. You'll need to explicitly mark any out-of-stock items using the Update Unavailabilities endpoint.
Item IDs not found
All Item IDs included in the request must exist in the specified catalogue. If any ID is not found, the entire request will fail and return a 404 error.
Rate Limit
This endpoint is rate-limited to ensure optimal performance:
- Standard Requests: Limited to 1 request per 100 milliseconds per site per brand.
- Requests with
reset_all_item_availabilitiesset totrue: Limited to 1 request per minute per site per brand.
Changing Unavailabilities During Catalogue Upload
Updating availabilities while a catalogue upload is in progress can lead to unpredictable behaviour, such as requests failing for newly created items. We recommend avoiding calling the update availabilities endpoint when the site's associated catalogue is still processing.