Skip to main content

API v1.58.0

: Staging

: Production

🚫 Deprecated

API

Removed deprecated features

The following deprecated features have been removed from the API:

  • Branding-related GraphQL types and fields
  • Core data types and queries
  • assignNavigation mutation
  • Deprecated Shop type fields
  • Fulfillment.totalLinesPrice field
  • Affiliates functionality
  • Channel-related types and fields
  • volumeDiscount field from orders

If you're still using any of these features, please update your integration before upgrading.

✨ New

Emails

Email rendering for order and quote events

Added support for rendering emails for the following events:

  • Pending orders
  • Order confirmations (including marketplace operator notifications)
  • Pending quotes
  • Quote requests

These emails now use global template variables for consistent branding and formatting across all email communications.

Customer mgmt

Customer upgrade to seller

Customers can now be upgraded to sellers directly through the API, streamlining the onboarding process for new marketplace vendors.

API

JWT authentication for single-tenant deployments

Added JWT authentication support for single-tenant installations, providing consistent authentication across all deployment types.

API

Metadata filtering for categories and product types

Added the ability to filter categories and product types by metadata, making it easier to organize and query your catalog based on custom attributes.

💎 Changed

API

Better error handling for unknown tenants

Requests to unknown tenants now return a proper 404 error instead of a generic error message, improving API error clarity.

Emails

Unified customer address rendering

Customer addresses are now consistently formatted across all email templates, improving the visual presentation of shipping and billing information.

🪲 Fixed

Emails

Fixed crashes in email rendering when processing certain recipient names and restored proper recipient handling for order confirmation emails.

Seller mgmt

Fixed an issue where updating a seller could fail if the slug conflicted with another seller's slug, now properly enforcing uniqueness constraints.

Checkout

Fixed an issue where checkout would not properly validate product availability, now correctly throwing an error when any product in the cart is unavailable.

Orders

Restored the totalLinesMoney resolver that was inadvertently removed, ensuring order line totals are calculated correctly.

API

Fixed GraphQL errors that could occur when querying designer data that doesn't exist, and corrected the error code returned when updating marketplace configuration.

Was this page helpful?