scriptoriumadmin/supermemory
1
0
Fork 0
mirror of https://github.com/supermemoryai/supermemory.git synced 2026-09-30 01:51:28 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

Align billing and Gmail docs with current plan entitlements (#1685)
Some checks failed
Publish Memory Graph / publish (push) Has been cancelled
Details

Browse source 
## Summary

The billing guide omits Max and contradicts the pricing page about Gmail access. Add Max ($100/month with $130 in monthly credits), correct the plan feature matrix, list all six current coding plugins as available on Free with credit-consuming usage, and update both remaining Scale-only requirements on the Gmail connector page to Max or above.

Clarify that paid-plan automatic top-up limits cap automatic credit purchases, not the total invoice, and correct the documented auto-topup update endpoint from PATCH to POST.

Companion website changes: https://github.com/supermemoryai/landing-2/pull/32

## Validation

- Compared prices, credit inclusions, connector gates, and top-up behavior with the console and API source on main. Verified that all six coding plugins are on FREE_TIER_PLUGIN_IDS and the authentication route bypasses the generic Pro gate for them. Usage still consumes plan credits.
- Checked Markdown table column counts and required Max entries; `git diff --check` passed.
- Confirmed the Gmail introduction, prerequisite, and troubleshooting requirement consistently say Max or above.
- Documentation-only change. A full Mintlify build was not run.

Crawler-access verification, AI-search benchmarking, and analytics/measurement work are excluded from this PR.
This commit is contained in:
shardulmane10 2026-09-18 22:01:05 +00:00
parent 8a4d9d76ae
commit 57b430b5b6
2 changed files with 27 additions and 22 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
apps/docs/connectors/gmail.mdx
View file

@ -383,7 +383,7 @@ The Gmail connector requests the following OAuth scopes:
<Warning>
**Important Limitations:**
- **Plan requirement**: Requires Scale Plan or Enterprise Plan
- **Plan requirement**: Requires Max Plan or above
- **INBOX only** for real-time sync: Only INBOX label triggers real-time updates; other labels sync via scheduled sync
- **Watch expiration**: Gmail watch subscriptions expire after 7 days (automatically renewed by supermemory)
- **Document limit**: Default limit is 10,000 threads per connection (configurable via `documentLimit` parameter)
@ -430,5 +430,5 @@ If real-time sync isn't working:
If you see permission errors:
- Ensure the user granted the required Gmail scopes during OAuth
- Verify your organization has Scale Plan or Enterprise Plan access
- Verify your organization has Max Plan or above access
- Check if the user revoked app access in their Google Account settings

45
apps/docs/overview/billing.mdx
View file

@ -16,7 +16,7 @@ Console charts are **estimates**. Invoice / customer-portal line items are autho
## Mental model
```text
PLAN (Free · Pro · Scale · Enterprise)
PLAN (Free · Pro · Max · Scale · Enterprise)
│ includes monthly USD credits
▼
USD CREDIT BALANCE ──draw──► METERS
@ -147,7 +147,7 @@ Connectors already use stable IDs (e.g. Drive file id, Gmail thread id, `s3://bu
| **Top-up credits** | Purchased USD credits (console presets e.g. 10 / 25 / 50 / 100 USD). Persist until used (do not expire with the calendar month the way subscription inclusion does) |
| **Spend order** | Plan inclusion is consumed before top-up balance (Autumn merges both into `usd_credits`) |
| **Auto top-up** | Configurable in console for paid plans — adds credits when balance is low |
| **Spend caps** | Scale+ supports hard caps so usage cannot run away |
| **Auto top-up purchase limits** | Paid plans can limit automatic credit purchases per interval. This is not a hard cap on total usage or the full invoice. |
| **Depleted balance** | Metered APIs may block (e.g. **402**) until top-up or period reset |
### Plan credit inclusion (approximate)
@ -156,6 +156,7 @@ Connectors already use stable IDs (e.g. Drive file id, Gmail thread id, `s3://bu
|---|---|---|
| Free | `api_free` | **5 USD** |
| Pro | `api_pro` | **20 USD** |
| Max | `api_max` | **130 USD** |
| Scale | `api_scale` | **600 USD** |
| Enterprise | `api_enterprise` | Custom / unlimited by contract |
@ -171,26 +172,30 @@ Usage meters are shared; **feature gates** differ by tier.
| Plan | Price (list) | Included credits | Best for |
|---|---|---|---|
| **Free** | 0 USD | 5 USD | Evaluate API, prototypes |
| **Pro** | 19 USD/mo | 20 USD | Developers, plugins, core connectors |
| **Free** | 0 USD | 5 USD | Plugins, API evaluation, prototypes |
| **Pro** | 19 USD/mo | 20 USD | Developers, core connectors |
| **Max** | 100 USD/mo | 130 USD | More usage headroom and Gmail |
| **Scale** | 399 USD/mo | 600 USD | Production, full connectors, teams |
| **Enterprise** | Custom | Contract | SSO, custom metering, FDE, air-gap |
### Feature matrix (code gates)
### Feature availability
| Feature | Free | Pro | Scale | Enterprise |
|---|---|---|---|---|
| Memory API, search, profiles | Yes | Yes | Yes | Yes |
| Diff / delta token billing | Yes | Yes | Yes | Yes |
| Plugins (Claude Code, Muse Code, Cursor, Hermes, …) | — | Yes | Yes | Yes |
| Team management | — | Yes | Yes | Yes |
| Google Drive, OneDrive, Notion connectors | — | Yes | Yes | Yes |
| Gmail, GitHub, S3, Web Crawler connectors | — | — | Yes | Yes |
| User Insights | — | — | Yes | Yes |
| Org seat limit (members) | 1 | 3 | Unlimited | Unlimited |
| Auto top-up | Limited | Yes | Yes | Contract |
| Spend caps | — | — | Yes | Contract |
| Custom metering / SSO / dedicated deploy | — | — | — | Yes |
| Feature | Free | Pro | Max | Scale | Enterprise |
|---|---|---|---|---|---|
| Memory API, search, profiles | Yes | Yes | Yes | Yes | Yes |
| Diff / delta token billing | Yes | Yes | Yes | Yes | Yes |
| Coding plugins (Claude Code, Codex, Cursor, OpenCode, OpenClaw, Hermes) | Yes | Yes | Yes | Yes | Yes |
| Team management | — | Yes | Yes | Yes | Yes |
| Google Drive, OneDrive, Notion, Granola connectors | — | Yes | Yes | Yes | Yes |
| Gmail connector | — | — | Yes | Yes | Yes |
| GitHub, S3, Web Crawler connectors | — | — | — | Yes | Yes |
| User Insights | — | — | — | Yes | Yes |
| Org seat limit (members) | 1 | 3 | 3 | Unlimited | Unlimited |
| Auto top-up in the console | — | Yes | Yes | Yes | Contract |
| Auto top-up purchase limits | — | Yes | Yes | Yes | Contract |
| Custom metering / SSO / dedicated deploy | — | — | — | — | Yes |
Coding plugins are available on every plan, including Free. Their API usage still consumes your plan's credits at the applicable rates.
Overrides can be applied per org in metadata (`featureOverrides`) for enterprise deals.
@ -268,7 +273,7 @@ Response includes `byFeature`, `byDay`, `memoryTotal`, `superragTotal`, period s
```http
GET /v3/auth/billing/auto-topups
PATCH /v3/auth/billing/auto-topups
POST /v3/auth/billing/auto-topups
```
### Invoices
@ -320,7 +325,7 @@ console.log({
3. Use **`dreaming: "instant"`** only when you need immediate memory (extra operation); default `"dynamic"` batches extraction.
4. Cache **profiles** short-TTL in your app if you call them every turn.
5. Scope with **`containerTag`** so you can delete/export a tenant without scanning the org.
6. Enable **spend caps / auto top-up** on Scale for predictable production.
6. Configure **auto top-up purchase limits** on paid plans and monitor usage separately. These limits do not cap the entire invoice.
7. Pull **`/v3/auth/billing/usage-events`** into your own FinOps dashboard for per-day Memory vs SuperRAG spend.
---