Client Management

Manage your reseller clients from the Reseller dashboard. Each client has independent quotas, API keys, and usage tracking.

Adding Clients

1. Navigate to Reseller → Clients
2. Click + Add Client
3. Fill in the details:

Field	Required	Description
Client Name	Yes	Company name or identifier
Contact Email	Yes	Primary contact email
Monthly Quota	Yes	API queries per month for this client
Rate Limit	No	Requests per minute (defaults to 60)
Notes	No	Internal notes about this client

4. Click Create Client

The client account is created immediately. Generate an API key to give them access.

Client Dashboard

Click any client to see their detail page:

Overview Tab

• Status — Active, Suspended, or Disabled
• Quota usage — Current period usage vs. allocation
• API keys — Active keys for this client
• Created date — When the client was added

Usage Tab

• Daily usage chart — Queries per day
• Endpoint breakdown — Which endpoints the client uses most
• Peak usage — Highest single-day usage

Settings Tab

• Edit quota — Increase or decrease the monthly allocation
• Edit rate limit — Adjust requests per minute
• Suspend/reactivate — Temporarily disable access
• Delete client — Permanently remove the client

Setting Client Quotas

Each client's quota is a portion of your Enterprise plan total:

Your Enterprise Quota: 999,999 queries/month
  Client A: 200,000 queries/month
  Client B: 100,000 queries/month
  Client C: 50,000 queries/month
  Your own usage: 649,999 queries/month remaining

Quota Overage Behavior

Configure what happens when a client exceeds their quota:

Option	Behavior
Hard limit	API returns 429 errors when quota is exhausted
Soft limit	Allow overage up to a specified buffer (e.g., +10%)
Unlimited	No limit — uses your shared pool (not recommended)

Recommendation

Use hard limits for most clients to prevent any single client from consuming your entire quota. Set a small buffer (5-10%) for premium clients.

Client Status

Status	Description	API Access
Active	Normal operation	Full access
Suspended	Temporarily paused	API returns 403
Disabled	Permanently removed	API returns 403, keys revoked

Suspending a Client

1. Open the client's detail page
2. Click Suspend
3. The client's API keys immediately stop working
4. Resume access anytime by clicking Reactivate

Suspension is useful for:

• Non-payment situations
• Abuse detection
• Temporary holds during client onboarding

Bulk Client Management

For managing many clients:

Import Clients

Upload a CSV to create multiple clients at once:

name,email,monthly_quota,rate_limit
Acme Corp,admin@acme.com,50000,60
Beta Inc,api@beta.io,100000,120
Gamma LLC,tech@gamma.com,25000,30

Export Client List

Download your complete client list as CSV with usage data for reporting.

Notifications

Receive notifications about your clients:

Event	Notification
Client reaches 80% quota	Email + in-app
Client exceeds quota	Email + in-app
Client API key created	In-app
Client suspended/reactivated	Email

Next Steps

• API Keys — Generate keys for your clients
• Billing — Track revenue and costs per client
• Reseller Setup — Initial configuration if not done