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/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/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.