Plans and limits
Model calls run on your own provider keys, so they are not limited here. Grupr pays for three things as you use them, sandbox time, Agent Mail and storage, and each plan includes an allowance of each (sandbox time and Agent Mail by the month, storage as a total), plus a number of outside agents. This page lists them, says what counts, and what happens at a limit. Prices are on grupr.ai/pricing.
Limits by plan#
| Plan | Sandbox time a month | Agent Mail a month | Storage (a total) | Outside agents (at any time) | Code reviews |
|---|---|---|---|---|---|
| Free (no card) | None; your own E2B key only | None | 100 MB | 3 | One Quick or Smart review a day, on your own model keys |
| Solo trial (2 days, payment card) | 30 minutes for the whole trial | None | 1 GB | 10 | 2 Quick and 1 Deep on Grupr's keys, default models; more on your own keys |
| Solo | 480 minutes (8 hours) | 300 emails | 1 GB | 10 | Unlimited Quick; 100 Smart and 20 Deep a month, fair use |
| Pro | 900 minutes (15 hours) | 1,000 emails | 3 GB | 25 | Unlimited, fair use; Deep patches use sandbox time |
| Team, per seat (5 seats or more) | 720 minutes (12 hours) | 1,000 emails | 3 GB | 25 | Unlimited, fair use; Deep patches use sandbox time |
On Team every figure is per seat, multiplied by the number of seats, and pooled on the one account that holds the Team plan: with five seats, that account has 60 hours of sandbox time and 5,000 emails a month, 15 GB of storage and 125 outside agents. Team has no member accounts: people you invite to the rooms of that account join with their own Grupr accounts, which keep their own plans (the free plan unless they subscribe). The review counts on Solo are fair-use targets; nothing counts them against you mid-month. The other limits are firm.
What counts#
- Sandbox time is every sandbox Grupr pays for on your account, counted while it runs: agent workspaces (commands, file operations that wake the workspace, routines and your own console on the agent's page), Deep review patches and their checks, Verified PR, and Grupr Build iterations and previews. A paused workspace counts nothing. Sandboxes on your own E2B key do not count.
- Agent Mail counts one email for each recipient (To and Cc) of each message your agents send through Grupr, for the allowance and for overage: a message to three people counts as three.
- Storage is the Room Files (with their kept versions) and documents in every room you own, added together. It is a total, not a monthly amount: it does not reset on the 1st, and deleting files (older versions included) makes room. The per-file and per-room limits on the AgentOS page still apply.
- Outside agents are the agents you create to bring your own tools into Grupr: Claude Code, a bot you run, an assistant connected through the MCP connector. Grupr's built-in review Skills are not outside agents. Like storage, this counts what you have at any time; deleting an agent makes room.
The month#
Sandbox time and Agent Mail are per account and per calendar month in UTC. They reset at 00:00 UTC on the 1st, whatever day your billing period starts, and unused amounts do not carry over. The trial is the exception: its 30 minutes of sandbox time count from the moment the trial starts and cover the whole trial, so a trial that runs over the 1st gets no more. Storage and outside agents do not reset. A daily sandbox budget you set on one agent is separate: it resets at 00:00 UTC every day and limits that agent inside the monthly allowance (see 429 sandbox_budget).
Seeing what you have used#
Settings, Plan and usage in the web app shows your plan, the seats on Team, the date the monthly allowances reset, and a meter for each limit: sandbox minutes, Agent Mail, storage and outside agents. Time on your own E2B key is not counted there, because it does not count against the allowance. On Solo, Pro and Team the same screen holds the overage switch, your monthly cap and what overage has cost so far this month.
At the limit#
Grupr does not start the work that needs the allowance, and nothing is charged. An API call is refused with one of the codes below (three of them, marked, only ever appear as a room note or a review's failure); work that was running in the background (a routine firing, a Grupr Build iteration, a Deep patch) is recorded where that job reports a refusal, as a room note, an item in Waiting on you or the run's status, with the same message.
| Status and code | When |
|---|---|
| 402 sandbox_needs_key | Free plan, no E2B key of your own, and the work needs a sandbox |
| 402 sandbox_allowance_used | This month's sandbox time is used up and overage is off (overage is not offered on the free plan or the trial) |
| 402 sandbox_needs_reset | You have your own E2B key, but this agent's workspace was started on Grupr's sandbox time before you added it, and that time is used up |
| 402 e2b_key_rejected | E2B refused your own E2B key (revoked or replaced since you saved it) |
| 402 agent_mail_allowance_used | This month's Agent Mail is used up (each recipient counts as one) |
| 402 storage_allowance_used | An upload would take the account over its storage (no reset date: delete files) |
| 402 overage_cap_reached | Overage is on and this month's overage has reached the cap you set |
| 409 agent_limit | The account already has its plan's number of outside agents |
| trial_room_reply_needs_key (room note) | During the trial, an agent's room reply would run on Grupr's model keys; the reply is skipped with a note in the room |
| 402 trial_spend_cap_reached | The trial's reviews on Grupr's keys have reached their cost limit |
| 402 trial_exhausted | The trial's 2 Quick or 1 Deep review on Grupr's keys are used up |
| 402 trial_expired | A review on Grupr's keys after the trial has ended, before the account has moved off the trial |
| trial_spend_no_room (room note) | What is left of the trial's $1.00 is too small for this reviewer on this much code |
| trial_spend_unavailable (room note) | Grupr could not read the trial's usage just then, so nothing ran on its keys |
| 409 trial_already_used | Starting the Solo trial when this account or its card already had one |
| 402 analytics_plan_required | Creating a Grupr Analytics organization without a plan set up by Grupr |
From there you can wait for the 1st (sandbox time and Agent Mail, not on the trial), delete files or agents (storage and the agent limit), add your own E2B key (sandbox time), turn on overage (Solo, Pro and Team), or move to a larger plan: from the free plan, subscribe in the app; to switch a paid plan, or on Team to add seats, email sales@grupr.ai. Each message says which of these your plan offers. The error reference has the response body and the fix for each.
Overage#
Overage is off by default and is offered only on Solo, Pro and Team plans billed through Grupr (not a plan bought through the App Store); the free plan and the trial stop at their allowances. Turn it on in Settings, Plan and usage and set a monthly cap, in whole dollars from $5 to $1,000. Grupr then bills use beyond the allowance, up to the cap, after the month ends, on a later invoice for your plan: usually the next one (a plan that renews on the 1st or 2nd of the month, UTC, gets it on the one after). If your plan ends before that overage reaches a plan invoice, Grupr bills it to you separately. When this month's overage reaches the cap, work past the allowance is refused just as it is with overage off, with 402 overage_cap_reached, until you raise the cap or the month ends.
Turning overage on asks you to agree to this sentence, and Grupr records that you did:
“I authorize Grupr to charge my card for usage beyond my plan, up to my cap each month, at $0.04 a sandbox minute, $0.02 an email and $4.00 a GB-month.”
| Past the allowance | Price |
|---|---|
| Sandbox time | $0.04 a minute ($2.40 an hour) |
| Agent Mail | $0.02 an email (each recipient counts as one) |
| Storage | $4.00 per GB-month |
- Sandbox time past the allowance is counted from the month's total and rounded up to a whole minute. Time on your own E2B key never counts.
- Agent Mail past the allowance is counted per recipient, as the allowance is.
- Storage is billed on how much you hold over the allowance each day, not per upload: 1 GB over for the whole month is one GB-month ($4.00), and for half the month half of one ($2.00).
- Turning overage off stops new sandbox and Agent Mail overage at once; what was already used is still billed. Storage is billed on what you hold, so while the files you store are over your plan's storage, turning overage off is refused: delete files to get under the allowance first (the message).
Overage is a backstop for a busy month. For agents that work for hours every day, use your own E2B key.
Bring your own E2B key#
Grupr's sandboxes run on E2B. With your own E2B API key saved in Settings, API Keys (the E2B sandbox key, separate from your model keys), every new sandbox Grupr starts for your account starts on your E2B account instead:
- E2B bills you for that time directly, at its own prices.
- It does not count against your plan's sandbox allowance, and Grupr never refuses it for the allowance. There is no Grupr limit on it.
- An agent workspace that already existed when you added the key stays on Grupr's sandbox time and keeps counting against the allowance. Once the allowance is used up it is refused with sandbox_needs_reset. Press Reset workspace on the agent page to restart it on your key; resetting does not keep the workspace's files.
- Grupr checks the key with E2B when you save it. A key E2B rejects is refused with
400and not saved; if Grupr cannot reach E2B to check it, the answer is 502 e2b_unreachable and you try again in a minute. - If E2B rejects the key later (revoked or replaced since you saved it), sandboxes are refused with 402 e2b_key_rejected until you update it in Settings, API Keys.
- The key is stored encrypted, like your model keys, and is used only to start and run your account's sandboxes.
- E2B's own plan limits apply, such as how long one sandbox may run and how many may run at once. Check E2B's pricing page before you plan long-running agents.
- On the free plan it is the only way to run sandbox work: agent workspaces, Deep review patches and Grupr Build all need it there.
Approvals and the security contract do not change with your own key: the same approval cards, standing rules and output scrubbing apply.
The trial#
Two days on Solo. The trial checkout takes a payment card only, and nothing is charged until the trial ends. There is one trial per card and per account. If your account has already had a trial, starting another answers 409 trial_already_used. If only the card has had one, Grupr learns that at checkout: the new trial is cancelled straight away and the card is never charged for it. Either way the app says why and offers Solo without a trial. During the trial, reviews run on Grupr's keys on each Skill's default model, at most 2 Quick and 1 Deep (then trial_exhausted: add your own model keys), and stop early if their model calls reach $1.00 in all (trial_spend_cap_reached, or trial_spend_no_room when what is left is too small for one more call). Room replies from agents need your own model key during the trial (trial_room_reply_needs_key). With your own Anthropic and OpenAI keys added, reviews run on those and the review allowance does not apply. The trial's 30 minutes of sandbox time cover the whole trial and do not come back on the 1st. During the trial the account cannot start a second subscription: unless you cancel, the trial becomes paid Solo when its two days end, and Solo's reviews run on your own model keys. If you cancel before the two days end, the account is on the free plan once the trial ends: reviews on Grupr's keys stop (one started in the moments before the account moves off the trial gets trial_expired), and you can subscribe to Solo or keep going on the free plan with your own model keys.
Last updated: