Skip to content

Usage Limits

Understand your limits and monitor consumption.

Message Limits

Tier Messages Overflow
Basic (free trial) 100 lifetime (no recurring reset) Not available — upgrade to continue past the cap
Medium 400/month $0.10/msg
Pro 1,500/month $0.10/msg

What counts: Each successful AI response = 1 message (regardless of length, model, or tokens)

What doesn't count: User messages, failed requests, or refunded errors

Message-based billing is simple

10 words or 1,000 words = same cost. No surprises based on response length.

Resource Limits

Resource Basic Medium Pro
Assistants 1 3 8
Knowledge Bases 1 2 5
Storage/Store 5 MB 30 MB 150 MB
Functions 1 5 15
Variables 5 20 75

Rate limits: Per-minute caps increase with tier to prevent abuse and ensure fair usage.

Monitoring Usage

  1. Go to Account in sidebar
  2. View progress bars for messages, storage, and resources
  3. Check reset date and days remaining

Progress bar colors:

  • Green (0-60%): Comfortable
  • Yellow (60-80%): Moderate
  • Orange (80-90%): Approaching limit
  • Red (90-100%): At limit

Reset Cycle

With subscription (Medium/Pro): Resets on billing cycle date (same day each month)

Basic (free trial): No reset — the 100-message allowance is lifetime per account. Once consumed, you must upgrade to continue.

Expired subscriptions: No automatic resets (resubscribe to resume)

Messages don't roll over (Medium/Pro)

On Medium and Pro, unused monthly quota resets completely each cycle — each month starts fresh.

Basic is one-time

The Basic 100-message allowance does not reset. Use it as a real evaluation budget, then upgrade when you're ready.

At Your Limits

Message limit reached:

  • Basic: 100-message lifetime allowance exhausted. Sending stops permanently — upgrade to Medium or Pro to continue.
  • Medium & Pro, STOP mode: Messages blocked until next monthly reset or upgrade
  • Medium & Pro, AUTO_PAY mode: $0.10/message from balance, service continues

Resource limits (assistants, stores, storage):

  • Can't create new resources
  • Delete existing or upgrade tier

Optimizing Usage

Tips to reduce message usage

Optimize assistant instructions

  • Clear, concise prompts reduce clarification rounds
  • Include common scenarios in system prompt
  • Lower temperature = more consistent responses

Use knowledge bases effectively

  • Pre-load FAQs and documentation
  • Enables complete first responses
  • Reduces back-and-forth questions

Add suggested questions

  • Guide users to efficient paths
  • Focus on high-value interactions

Use functions for data lookups

  • Shopify product search reduces inventory questions
  • More accurate, structured responses
Tips to optimize storage

Clean up knowledge bases

  • Remove outdated docs
  • Archive seasonal content
  • Delete duplicate files

Optimize files before upload

  • Remove unnecessary formatting
  • Compress images
  • Extract text from PDFs

Use multiple stores strategically

  • Separate by topic/product
  • Attach only relevant stores to assistants
  • Improves RAG accuracy

Common Questions

Do test messages count?

Yes. All messages count (chat interface, widget, integrations, API).

What if I hit my limit mid-conversation?

Basic: Conversation pauses at the 100-message lifetime cap — upgrade to keep going. | Medium/Pro STOP mode: Conversation ends | Medium/Pro AUTO_PAY mode: Continues at $0.10/message from balance

Can I buy extra messages without upgrading?

Only on Medium and Pro. Enable AUTO_PAY and add balance via top-ups. On the free Basic trial, the 100 messages are a one-time allowance — the only way past the cap is to upgrade. Upgrading is usually more cost-effective once you're consistently exceeding your tier limit.

What happens if my subscription expires?

Tier reverts to Basic with no automatic resets. Resubscribe to resume.

Next Steps