Docs
    GuidesAPI Reference
    Sign inCreate account
    Overview

    Getting started

    API keysQuickstart

    Integration

    Load your catalogTracking EventsIdentity StitchingPersonalisation

    Production

    Errors & troubleshootingRetries & rate limits

    Reference

    API ReferenceVersioningChangelog
    HomeDocumentationChangelog
    Previous
    Versioning

    Skip the ML, Ship the Revenue

    Product

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

    Developers

    • Documentation

    Company

    • 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 /v1/ingest/events/ingest with eight standard event names plus open custom names.
    • AddedRecommendations. POST /v1/recommend with 14 strategies (personalized, similar, session-based, trending, popular, and more), all sharing the same response shape.
    • AddedCatalog ingestion. Bulk CSV/JSON upload via the dashboard plus incremental upsert via POST /v1/ingest/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. The 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. See Versioning for what counts as a breaking change.