docsResourcesChangelog

API Changelog

Track changes to the Lorn AI API.

Versioning

Lorn AI uses date-based API versioning in the format YYYY-MM-DD. Include the version in requests:

curl "https://{{YOUR_STORE_URL}}/acp/products" \
  -H "API-Version: 2025-01-01"

When no version is specified, the latest stable version is used.

Version History

2025-01-01 (Current)

Released: January 1, 2025

This is the initial stable release of the Lorn AI API.

Features

  • Product Discovery

    • Semantic search with OpenAI embeddings and pgvector
    • Filter by category, tag, and price range
    • Pagination support

  • Checkout Sessions

    • Create, update, complete, and cancel checkout sessions
    • Full cart state in every response
    • Automatic tax and shipping calculation

  • Webhooks

    • Order lifecycle event emission
    • HMAC-SHA256 signature verification
    • Configurable target URLs

Endpoints

MethodEndpointDescription
GET/healthHealth check
GET/acp/productsSearch products
GET/acp/products/searchSearch products (alias)
GET/acp/products/{id}Get product
POST/checkout_sessionsCreate checkout
GET/checkout_sessions/{id}Get checkout
PATCH/checkout_sessions/{id}Update checkout
POST/checkout_sessions/{id}/completeComplete checkout
POST/checkout_sessions/{id}/cancelCancel checkout
POST/webhooks/emitEmit webhook

Upcoming Changes

Planned for 2025-Q2

  • MCP Server Support — Model Context Protocol integration
  • Fulfillment Options API — Multiple shipping methods
  • Discount Codes — Apply promotional discounts
  • Order Tracking — Post-purchase order status

Under Consideration

  • GraphQL API alternative
  • Batch product operations
  • Real-time inventory webhooks
  • Multi-currency support

Deprecation Policy

  • Notice Period: Minimum 6 months before deprecation
  • Sunset Period: APIs remain functional for 12 months after deprecation notice
  • Communication: Email notifications to all API key owners

Currently Deprecated

No deprecated endpoints at this time.

Migration Guides

Migration guides will be published here when breaking changes are introduced.

SDK Updates

Track SDK versions alongside API versions:

SDKVersionAPI Version
Python1.0.02025-01-01
TypeScript1.0.02025-01-01
Java1.0.02025-01-01
Go1.0.02025-01-01

Release Notes

January 2025

Week 1 (Jan 1-7)

  • Initial public release of Lorn AI API
  • Documentation launch
  • SDK examples for Python, TypeScript, Java, and Go

Subscribing to Updates

Stay informed about API changes:

  1. Email — API key owners receive automatic notifications
  2. GitHub — Watch the documentation repository
  3. Status Page — Subscribe to status.lorn.ai

Feedback

We welcome feedback on the API:

Support Policy

VersionStatusSupport Until
2025-01-01CurrentActive development

Older versions receive security fixes for 12 months after the release of a newer version.

Error Codes