Skip to content

docs: document pausing event streams#2617

Open
alnr wants to merge 1 commit into
masterfrom
alnr/pause-event-streams
Open

docs: document pausing event streams#2617
alnr wants to merge 1 commit into
masterfrom
alnr/pause-event-streams

Conversation

@alnr

@alnr alnr commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Documents the new ability to pause event streams, shipped in ory-corp/cloud#12238.

Adds a Pause and resume event streams section to the live event streams guide:

  • How to pause/resume a stream from the Ory Console (and via the API as a partial status update).
  • How to create a stream as paused.
  • What happens to events while a stream is paused — the key behavior: events keep accumulating and are buffered for up to 7 days. Resuming within that window delivers the buffered backlog (best-effort, possibly out of order, possibly duplicated); events older than 7 days are permanently discarded.

The 7-day figure matches the event streamer's Pub/Sub subscription retention (RetentionDuration: 7 days); the explanation is written in vendor-neutral, user-facing terms.

Implementation PR: ory-corp/cloud#12238

Add a "Pause and resume event streams" section to the live event streams
guide covering how to pause/resume a stream from the Ory Console, how to
create a stream as paused, and what happens to events while a stream is
paused.

Most importantly, it explains the buffering behavior: while paused, events
keep accumulating and are retained for up to 7 days. Resuming within that
window delivers the buffered backlog; events older than 7 days are
permanently discarded.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings June 9, 2026 12:25
@alnr alnr requested review from aeneasr, unatasha8 and vinckr as code owners June 9, 2026 12:25

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds documentation to the Live event streams guide explaining how to pause/resume streams (Console + API), how to create streams in a paused state, and what happens to events during a pause (buffering/retention behavior).

Changes:

  • Document pausing/resuming event streams via Ory Console and API status updates.
  • Document creating an event stream with initial status paused.
  • Explain buffering semantics while paused (up to 7 days), including delivery characteristics on resume and discard behavior after retention.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/actions/live-events.mdx
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants