FlowRelay
Operate
Usage limits
Usage limits are FlowRelay plan controls, not traffic-shaping or spike-protection features.
Current plan meters #
FlowRelay tracks capacity for accepted events and Agent Operations work. The embedded Plan page and Agent Operations plan-usage response expose exact enforced limits plus paid-plan event grace state so humans and authorized agents can self-throttle before work pauses.
| Meter | What it controls |
|---|---|
| Accepted events | Inbound events accepted by FlowRelay for processing during the plan period. |
| Diagnostics shares | Private, redacted diagnostics shares created for support, a partner, or an authorized agent. |
| Replay executions | Intentional reruns of retained events. Replay can repeat downstream actions. |
| Simple agent reads | Compact setup, grant, plan, billing-handoff, and recent-result reads. |
| Rich agent reads | Heavier event, endpoint, diagnostics, reliability, or history reads. |
| Action previews | Preview or proposal records for approved actions before anything changes. The API key remains actionIntents. |
| Executed actions | Confirmed approved actions such as replay, diagnostics-share creation, endpoint tests, endpoint changes, or secret rotation. |
Paid-plan event grace #
Starter, Growth, and Scale include a bounded event-intake grace allowance for the current usage period after the included accepted-event cap is reached. Events accepted during grace are still stored, metered, and handed off normally when the rest of the receipt path succeeds. The embedded Plan page and Agent Operations plan-usage response show the exact grace state and remaining allowance when it matters. FlowRelay does not create silent overage charges; more capacity requires an explicit upgrade, approved add-on, or custom-plan approval through Shopify billing or support handoff.
Published monthly plan limits #
These are the plan limits most merchants compare first: event intake, recovery tools, Agent Access posture, and retained event history.
| Plan | Accepted events | Diagnostics shares | Replay executions | Agent Access | Event history |
|---|---|---|---|---|---|
| Free/Test | 500 | 25 | 25 | Included with published limits | 30 days |
| Starter | 25,000 | 1,000 | 500 | Included with published limits | 30 days |
| Growth | 250,000 | 10,000 | 5,000 | Included with published limits | 30 days |
| Scale | 1,000,000 | 50,000 | 25,000 | Expanded published limits | 30 days |
Agent Operations limits #
Agent Access is included with each plan. Events are normal sender traffic; Agent Operations are controlled operator work, so automated reads, action previews, and executed actions use their own published monthly protective limits.
| Plan | Simple reads | Rich reads | Action previews | Executed actions |
|---|---|---|---|---|
| Free/Test | 5,000 | 100 | 200 | 100 |
| Starter | 250,000 | 10,000 | 4,000 | 2,000 |
| Growth | 2,500,000 | 100,000 | 40,000 | 20,000 |
| Scale | 10,000,000 | 500,000 | 200,000 | 100,000 |
Why Agent Operations limits are lower #
Events are normal sender traffic. Agent Operations are operator work: they inspect richer context, create auditable previews, or change something after confirmation. Most stores need many more events than approved recovery interventions, and higher plans include larger Agent Operations allowances for busier recovery work.
Common cases #
Use the action being taken, not the screen or actor, to predict which meters move.
| Case | Meters that move | Why |
|---|---|---|
| An authorized agent checks whether the store is installed, the grant is valid, usage is healthy, or the latest handoff succeeded. | Simple agent reads | FlowRelay is returning compact status so the agent can decide whether deeper investigation is needed. |
| A human or agent opens a failed event, endpoint snapshot, diagnostics preview, or event-history view to understand what happened. | Rich agent reads | FlowRelay is returning detailed operational context, not just a summary. |
| An agent prepares a replay, diagnostics share, endpoint test, endpoint change, or secret rotation for human approval. | Action previews | The proposal is recorded and auditable, but nothing has changed yet. |
| The merchant approves replaying one retained event. | Replay executions and executed actions | FlowRelay reruns the event, which can repeat downstream actions, and records the approved execution. |
| The merchant or authorized agent creates a redacted diagnostics share for support or a partner. | Diagnostics shares and executed actions | FlowRelay creates a private support bundle and records the approved execution. |
| The merchant approves an endpoint test, endpoint change, or secret rotation. | Executed actions | FlowRelay performs an approved operation. Replay and diagnostics-share meters move only when that operation also creates a replay or share. |
What usage limits do not control #
Usage limits are plan controls. They do not create configurable retry schedules, custom rate limits, endpoint-level throttling, user-managed queue buffering, automatic spike protection, or general webhook traffic management.
Recovery visibility at limits #
Diagnostics shares and replay executions are operator tools, not coverage percentages. Existing event history, receipts, error context, diagnostics, replay history, and recovery guidance stay visible when a limit is reached or event intake is in grace. The operator can upgrade, approve an add-on, request a custom plan, wait for the next period, or reduce limit-consuming work.
Operating guidance
Apply the concept through the receipt before changing setup, resending, or replaying.
- 01Open Plan from the top navigation or use the Home Plan & usage card in FlowRelay to check accepted event, diagnostics share, replay, agent read, action-preview, and executed-action meters.
- 02Treat warning states as a capacity planning signal before production senders hit the limit.
- 03If a paid plan reaches its included accepted-event cap, FlowRelay enters a bounded event-intake grace allowance for the current usage period before blocking new intake.
- 04Free/Test can block at its included cap, and paid plans block only after event grace is exhausted, abuse or billing failure applies, or the next capacity approval has not happened.
- 05If Agent Operations limits are reached, reduce unnecessary agent reads or upgrade before asking an agent to continue high-volume work.
- 06Use plan meters for capacity planning. Usage limits do not provide configurable traffic shaping, endpoint throttling, or spike buffering.