Docs
    GuidesAPI ReferenceBlog
    Sign inCreate account
    Overview

    Getting started

    Sign upAPI keysQuickstartLoad your catalog

    Integration

    Tracking EventsIdentity StitchingPersonalisation

    Production

    Errors & status codesRetries & rate limitsTypeScript SDKTroubleshooting

    Reference

    API ReferenceVersioningChangelog
    HomeDocumentationChangelog
    Previous
    Versioning

    Skip the ML, Ship the Revenue

    Product

    • How It Works
    • Features
    • For Startups
    • For Developers

    Developers

    • Documentation

    Company

    • Blog
    • Contact

    © 2026 Lehnz, Inc. All rights reserved.

    Reference

    Changelog

    Every notable change to the lehnz API. See Versioning for what counts as a breaking change.

    v1 — Initial release (2026)

    • AddedEvents ingestion. POST /api/v1/events/ingest with eight standard event names plus open custom names.
    • AddedRecommendations. Five modes — user, item-similar, session, basket, price-optimized — all sharing the same response shape.
    • AddedCatalog ingestion. Bulk CSV/JSON upload via the dashboard plus incremental upsert via POST /api/v1/items/upsert and /users/upsert.
    • AddedIdentity stitching. The identify event merges anonymous and authenticated profiles via previous_user_id.
    • AddedAttribution. Every recommendation response includes a recommendation_id that you echo back on click and purchase events to close the loop.
    • AddedOrganizations & teams. Multi-tenant model with OWNER, ADMIN, DEVELOPER, MEMBER roles, and an audit log per organization.
    • AddedAPI key pairs. Publishable (lehnz_pk_) for client-side, secret (lehnz_sk_) for server-side. Server enforces key-type per endpoint.
    • AddedRate limit headers. All responses include RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset per RFC draft-7.
    Future entries appear above this

    Future releases will be dated by month. Subscribe to the versioning policy for what counts as a breaking change.