From 6de15ccd27bf0b744f971e64bf94f52889c47767 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 13 Apr 2026 19:05:49 +0000 Subject: [PATCH] docs: update sandbox cap to wallet-level (per-account, not per-key) Generated-By: mintlify-agent --- authentication.mdx | 2 +- billing.mdx | 8 ++++---- errors.mdx | 8 ++++---- introduction.mdx | 2 +- quickstart.mdx | 2 +- rate-limits.mdx | 2 +- 6 files changed, 12 insertions(+), 12 deletions(-) diff --git a/authentication.mdx b/authentication.mdx index 402154b..0acb0c9 100644 --- a/authentication.mdx +++ b/authentication.mdx @@ -22,7 +22,7 @@ Authorization: Bearer nawa_live_sk_xxx **Free, no credit card required.** - - 100 lifetime requests + - 100 lifetime requests per account (shared across all free keys) - 14-day key expiry - Uses real AI models (same accuracy) - Rate limit: 10 requests/minute diff --git a/billing.mdx b/billing.mdx index e28bb54..3bf3bbf 100644 --- a/billing.mdx +++ b/billing.mdx @@ -16,13 +16,13 @@ NAWA uses a prepaid credit system. - - **100 lifetime requests** per free key (`nawa_test_sk_`) + - **100 lifetime requests per account** across all free keys (`nawa_test_sk_`) - 14-day key expiry - No credit card required - Uses real AI models -- same accuracy as paid - Rate limit: 10 requests/minute - Free endpoints (health, usage, analytics, comments, feedback) do not count toward the 100 limit - - When exhausted: create a new free key or purchase credits for a live key + - When exhausted: purchase credits for a live key @@ -82,7 +82,7 @@ When your credit balance reaches 0: - All paid endpoints return `402 insufficient_credits` - Free endpoints continue to work normally -- Free keys (`nawa_test_sk_`) are unaffected -- they use their own 100-request pool +- Free keys (`nawa_test_sk_`) are unaffected -- they use their own 100-request-per-account pool - Purchase any credit pack to restore access immediately @@ -114,7 +114,7 @@ Refunds for unused credits are processed to the original payment method within 5 - No. Free keys (`nawa_test_sk_`) have their own pool of 100 lifetime requests. Paid credits are only consumed by live keys (`nawa_live_sk_`). + No. Free keys (`nawa_test_sk_`) have their own pool of 100 lifetime requests per account. Paid credits are only consumed by live keys (`nawa_live_sk_`). No. Credits never expire. Use them at your own pace. diff --git a/errors.mdx b/errors.mdx index fdcf365..ece63b8 100644 --- a/errors.mdx +++ b/errors.mdx @@ -219,16 +219,16 @@ You've exceeded the rate limit for your current tier. - **Cause:** You've used all 100 lifetime requests on your free key. + **Cause:** You have used all 100 free sandbox requests on your account. This limit is enforced across all of your free keys, including revoked and expired ones. Creating new free keys does not reset the counter. - **Fix:** Buy credits to unlock a live key. + **Fix:** Buy credits to continue making API calls. ```json { "type": "rate_limit_error", "code": "sandbox_exhausted", - "message": "Free key lifetime limit of 100 requests reached.", - "suggested_action": "Buy credits to create a live API key at trynawa.com/developers/keys." + "message": "You have used all 100 free sandbox requests on this account.", + "suggested_action": "Buy credits to continue making API calls." } ``` diff --git a/introduction.mdx b/introduction.mdx index 5618464..6d644e5 100644 --- a/introduction.mdx +++ b/introduction.mdx @@ -59,7 +59,7 @@ NAWA is the language intelligence platform for Arabic and English. Classify comm | Cost per moderate | $0.004 | | Cost per report (Basic) | $0.50 | | Cost per report (Pro) | $1.50 | -| Free tier | 100 requests, no credit card | +| Free tier | 100 requests per account, no credit card | | Uptime SLA | 99.9% | ## Quick taste diff --git a/quickstart.mdx b/quickstart.mdx index 8d1384c..c489c42 100644 --- a/quickstart.mdx +++ b/quickstart.mdx @@ -13,7 +13,7 @@ Get up and running with the NAWA classification API in three steps. Go to [trynawa.com/developers/keys](https://trynawa.com/developers/keys) to create your free API key. Sign in with Google or email - no credit card required. - Free keys (`nawa_test_sk_xxx`) require no credit card. Limited to 100 lifetime requests and 14-day expiry. They use real AI models - same accuracy as paid keys. + Free keys (`nawa_test_sk_xxx`) require no credit card. Limited to 100 lifetime requests per account (shared across all your free keys) and 14-day expiry. They use real AI models - same accuracy as paid keys. diff --git a/rate-limits.mdx b/rate-limits.mdx index 26c3d15..3aee792 100644 --- a/rate-limits.mdx +++ b/rate-limits.mdx @@ -16,7 +16,7 @@ NAWA enforces per-minute rate limits on each API key to ensure fair usage and pl | **Enterprise+** | 1,000 | Contact [sales@trynawa.com](mailto:sales@trynawa.com) | - Free keys are rate-limited to 10 requests/minute and have a hard cap of 100 lifetime requests. Live keys start at the Growth tier (120/min). Enterprise tiers are available on request -- contact [sales@trynawa.com](mailto:sales@trynawa.com). + Free keys are rate-limited to 10 requests/minute and have a hard cap of 100 lifetime requests per account (shared across all free keys, including revoked ones). Live keys start at the Growth tier (120/min). Enterprise tiers are available on request -- contact [sales@trynawa.com](mailto:sales@trynawa.com). ## Rate limit headers