FlowRelay Docs Shopify Flow
All docs pages

START

USE CASES

SET UP

OPERATE

RECOVER

AGENT ACCESS

REFERENCE

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 governed operational work. The embedded Plan page and Agent Operations plan-usage response expose exact enforced meters so humans and authorized agents can self-throttle before work pauses.

MeterWhat it controls
Accepted eventsInbound events accepted by FlowRelay for processing during the plan period.
Diagnostics sharesPrivate, support-safe diagnostics bundles created for support, a partner, or an authorized agent.
Replay executionsIntentional reruns of retained events. Replay can repeat downstream actions.
Simple agent readsCompact setup, grant, plan, billing-handoff, and recent-result reads.
Rich agent readsHeavier event, endpoint, diagnostics, reliability, or history reads.
Action intentsPreview or proposal records for governed actions before anything changes.
Executed actionsConfirmed governed actions such as replay, diagnostics-share creation, endpoint tests, endpoint changes, or secret rotation.

Common cases #

Use the action being taken, not the screen or actor, to predict which meters move.

CaseMeters that moveWhy
An authorized agent checks whether the store is installed, the grant is valid, usage is healthy, or the latest handoff succeeded.Simple agent readsFlowRelay 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 readsFlowRelay 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 intentsThe proposal is recorded and auditable, but nothing has changed yet.
The merchant approves replaying one retained event.Replay executions and executed actionsFlowRelay reruns the event, which can repeat downstream actions, and records the governed execution.
The merchant or authorized agent creates a redacted diagnostics share for support or a partner.Diagnostics shares and executed actionsFlowRelay creates a private support bundle and records the governed execution.
The merchant approves an endpoint test, endpoint change, or secret rotation.Executed actionsFlowRelay performs a governed 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, and recovery guidance stay visible when a limit is reached. The operator can upgrade, wait for the next period, or reduce limit-consuming work.

Operating guidance

Apply the concept through the receipt before changing setup, resending, or replaying.

  1. 01Open Plan or Home in FlowRelay to check accepted event, diagnostics share, replay, agent read, action-intent, and executed-action meters.
  2. 02Treat warning states as a capacity planning signal before production senders hit the limit.
  3. 03If the accepted-event cap is reached, new limit-consuming intake can be blocked while existing receipts, diagnostics, replay history, and recovery guidance remain readable.
  4. 04If governed operation caps are reached, reduce unnecessary agent reads or upgrade before asking an agent to continue high-volume work.
  5. 05Use plan meters for capacity planning. Usage limits do not provide configurable traffic shaping, endpoint throttling, or spike buffering.