API Updates and Announcement for February 13, 2025

Announcement

Validation for channel_id in POST/PUT /v2/orders

The v2 Orders API now validates the channel_id field in both the Create an Order and Update an Order endpoints. Previously, invalid or non-existent channel_id values were accepted without error, potentially leading to data integrity issues. With this update, passing an invalid channel_id will result in a 400 error, ensuring better data hygiene.

API Updates

Platform Limits - Added platform limits for the Inventory Adjustments and Locations APIs.

JWT Session-Sync Limits - Added a note regarding the number of invalid session-sync JWT tokens allowed before the system blocks an IP address. See the Headless/GraphQL account login section for details.

Catalog Updates

Best practices for Channel Assignment endpoint - Added best practices for using the Create Products Channel Assignment endpoint.

New endpoint - Added the Get All Bulk Pricing Rules endpoint.

Category trees usage notes & limits - Clarified the Create Categories depth limit and corrected the requirement for upserting category trees.

Checkout Updates

New fields - Added custom_checkout_sri_hash and custom_order_confirmation_sri_hash to Get and Put Checkout Settings endpoints to allow merchants to provide a SRI hash for their custom checkout.

B2B Updates

B2B Storefront Auth Token API response - Updated documentation to reflect that the Get a B2B StorefrontToken API returns a token as an array of strings, not a single string.

Stencil Updates

Added handlebar helper - Added getImageSrcset1x2x to the list of available Custom helpers.

Enhancements & Fixes

Removed an outdated note from the Get Email Templates and Get an Email Templates endpoints.

Reorganized sections in the Orders Overview to reflect when tracking information becomes available.

Corrected schema details for store/order/transaction/created.

Fixed various broken links in the developer documentation.