From 57b430b5b6a19106a989651f4cde853c05147682 Mon Sep 17 00:00:00 2001 From: shardulmane10 <123568850+shardulmane10@users.noreply.github.com> Date: Fri, 18 Sep 2026 22:01:05 +0000 Subject: [PATCH] Align billing and Gmail docs with current plan entitlements (#1685) ## 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. --- apps/docs/connectors/gmail.mdx | 4 +-- apps/docs/overview/billing.mdx | 45 +++++++++++++++++++--------------- 2 files changed, 27 insertions(+), 22 deletions(-) diff --git a/apps/docs/connectors/gmail.mdx b/apps/docs/connectors/gmail.mdx index 73e5063e..b0b0c3f8 100644 --- a/apps/docs/connectors/gmail.mdx +++ b/apps/docs/connectors/gmail.mdx @@ -383,7 +383,7 @@ The Gmail connector requests the following OAuth scopes: **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 diff --git a/apps/docs/overview/billing.mdx b/apps/docs/overview/billing.mdx index 86080c4a..2ffb411c 100644 --- a/apps/docs/overview/billing.mdx +++ b/apps/docs/overview/billing.mdx @@ -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. ---