API ยท v1

Snapshot and events

Rebuild your local projection with snapshot plus catch-up pages, then resume the stream.

Snapshot

GET/api/v1/output/feeds/{token}/snapshot

Reads active output positions and the event high-watermark in one repeatable-read transaction scoped to the feed execution. Atomically replace the receiver's modeled projection and save its cursor.

Events catch-up

GET/api/v1/output/feeds/{token}/events

Call with after={cursor} until has_more is false, applying each page and cursor in one local transaction.

Cursors

Cursors are opaque, signed, versioned, and tied to both the feed and execution. Never decode, modify, or reuse a cursor on another feed. A malformed, cross-feed, or cross-execution cursor returns 400 {"error":"invalid_cursor"}.

Limits and errors

TopicValue
Shared rate limit300 requests per 60 seconds per feed
Page size1-500 (default 100)
Rate limited429 with Retry-After: 60
Missing or revoked token404 {"error":"invalid_feed"}