API changelog

Pin a version with the TYS-Version header. Without it, the latest version answers. See Versioning.

Latest version: 2026-10-25 (header TYS-Version)

2026-10-25

Released 2026-10-25. First dated version of the server API.

• Added: POST /v1/recommendations: the shopper's size for your server or headless storefront, from a handle the browser SDK issues (tys.recommendationHandle()).
• Added: Catalog API with secret and restricted keys: /v1/products, /v1/products/{product}/size_map, /v1/products/{product}/garments, /v1/garments/{garment_id}(/publish), /v1/fit_groups.
• Added: Idempotency-Key on POST requests made with secret and restricted keys (responses stored for 24 hours).
• Added: Errors carry code, doc_url and request_id; every response carries X-Request-ID and TYS-Version.
• Added: Cursor pagination for lists: limit, cursor → data, has_more, next_cursor.
• Note: Orders and returns (POST /v1/orders, /v1/returns) and webhooks (envelope api_version "2026-10") are part of this version.

This page is generated from the API’s version list at build time.