API Updates for January 17, 2025

API

We are happy to announce you can manage languages across different channels. Using the GraphQL Admin API, merchants can add, update, or remove locales for each sales channel, change locale status, and set a locale as the default.

When submitting a shipping cost for the POST and PUT v2 orders request, you must now include shipping_cost_inc_tax and shipping_cost_ex_tax in the payload. This change ensures accurate calculations and prevents negative shipping cost tax values.

Enhancements

Removed the beta label since the Storefront Form Fields API is generally available.

Removed the deprecated show_inclusive_in_control_panel field and added the control_panel_price_display_strategy field in the Tax Settings API.

Added a 422 error response to the Update a product image endpoint.

Added an “Avoiding infinite loops” section to our Tax Provider API guide to describe avoiding infinite loops. This topic has caused some disruption a handful of times over the years.

Added clarification in the Get facets section of Faceted and Textual Search with the GraphQL Storefront API to prevent confusion when nodes return empty results.

Bug Fix

Added and updated field limitations for the Create Categories endpoint.