Changelog
What changed.
Dated and hand-written, newest first. A schema is always "now"; an integration is "then" — this page is what lets you trust that a breaking change would have been announced. Additions arrive without an entry; anything deprecated or removed always gets one, six months before it takes effect.
2026-08-17 · Added
The API becomes publicly documented.
These pages, the generated reference at app.summely.com/api/redoc/, and API keys created in the app under More → API keys. Everything before this date was the private contract between the Summely apps and the service; from this date, the published surface carries the v1 stability promise.
2026-08-17 · Added
Sandbox books, and mode-carrying keys.
Create a separate, free sandbox organisation from More → API keys.
Keys minted there begin smly_test_ and can only reach
that sandbox; keys on real books begin smly_live_. A
test key presented against live books fails authentication.
How to use it.
Keys issued before this date begin ldg_ and continue to
work as live keys until they expire. Rotate one when convenient —
rotation mints the replacement before the original stops working, so
nothing goes dark.
2026-08-17 · Added
A cursored change feed.
GET /changes answers "what changed since my last
cursor" across the whole organisation — the supported alternative to
webhooks, and one request instead of a sweep of every collection.
The contract.
Build on it.
The getting-started page takes five minutes; the worked flow takes six requests.