Delivery API
Delivery: server SDKs
Fetch the current or a historical snapshot with a server key, and the optional hint stream.
The SDK polls the latest snapshot with If-None-Match; an unchanged environment answers 304. Historical snapshots are immutable and cacheable for a year.
The hint stream (Server-Sent Events) is off unless the deployment sets SSE_ENABLED; it carries only version numbers, never snapshot bodies. Requests are rate-limited per key: 60 per second, burst 120.
Operations
| Operation | Request | Who may call it |
|---|---|---|
| getSnapshot | GET /v1/snapshot | server key |
| getSnapshotVersion | GET /v1/snapshot/{version} | server key |
| streamHints | GET /v1/stream | server key |
Management API requests carry a user token and are checked against the caller’s organization role. Delivery API requests carry an SDK key; the two never cross. Errors are always { error: { code, message } }.