When you hit the cap

What happens when a workspace exceeds its monthly session quota , and what your options are.

The behaviour

On the first session created after the cap is hit:

• The ingest API returns 429 quota_exceeded.
• That session is rolled back, no row is written, no events stored.
• The visitor is silently missing from Replayful for the rest of the month.

What still works

• Sessions that started before the cap continue. We don't enforce the cap on the events endpoint, so any recording that's already in progress flushes to completion.
• The dashboard remains accessible. You can still play back existing sessions, look at analytics, and manage the workspace.
• The session counter keeps incrementing. Even blocked sessions count toward the visible usage number, so you can see how far over the cap you went.

The reset

Counters reset on the first day of the next calendar month UTC. Ingest immediately resumes accepting new sessions.

If you need to keep recording now

Use the in-app plan picker to upgrade. Plan changes are immediate; recording resumes the moment the new quota kicks in. See Upgrading plans.

Heads-up before the cliff

We'll surface a usage banner in the dashboard when a workspace passes 80% of its monthly cap, with a one-click path to the plan picker. Email warnings to workspace Owners are on the roadmap.