📈 Usage Limits & Quotas
Understand query limits, rate limiting, and resource quotas to optimize your usage.
Overview
Usage limits protect system performance and ensure fair resource allocation:
- Monthly query quotas
- API rate limits
- Concurrent query limits
- Resource quotas (agents, data sources, users)
- Storage limits
Query Limits
Monthly Quotas by Plan
Plan Monthly Queries
─────────────────────────────
Starter 1,000
Growth 10,000
Scale 50,000
What Counts as a Query?
Each of these counts as 1 query:
- ✅ Natural language question
- ✅ Template execution
- ✅ Workflow query action
- ✅ Autonomous agent query
- ❌ Viewing saved results (free)
- ❌ API metadata requests (free)
Multi-Database Query Counting
Special rules for multi-database queries:
- Single query across 2 databases = 1 query
- Each additional database = +0.5 query
- Example: Query across 4 databases = 2.5 queries
Quota Enforcement
When you exceed monthly quota:
- Warnings at 80% and 90%
- At 100%: Queries paused (soft limit)
- Can purchase overages at $10 per 1,000
- Auto-resume next billing cycle
Rate Limits
API Rate Limits
Endpoint Limit Window
─────────────────────────────────────────────
/api/queries 60 requests 1 minute
/api/templates 30 requests 1 minute
/api/agents 20 requests 1 minute
/api/integrations 10 requests 1 minute
/api/auth/* 5 requests 1 minute
Rate Limit Headers
APIs return rate limit information:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1640995200
Retry-After: 45
Rate Limit Exceeded
HTTP/1.1 429 Too Many Requests
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded. Try again in 45 seconds",
"retry_after": 45
}
Concurrent Limits
Concurrent Queries
Maximum simultaneous queries:
- Starter: 2 concurrent queries
- Growth: 5 concurrent queries
- Scale: 20 concurrent queries
Concurrent Connections
WebSocket connection limits:
- Per User: 3 connections (different devices)
- Per Organization: Based on team size
Resource Quotas
Data Sources
Plan Max Data Sources
─────────────────────────────
Starter 3
Growth 10
Scale Unlimited
AI Agents
Plan Max AI Agents
─────────────────────────────
Starter 5
Growth 20
Scale Unlimited
Team Members
Plan Max Users
─────────────────────────────
Starter 5
Growth 15
Scale Unlimited
Storage
Plan Storage Limit
─────────────────────────────
Starter 10 GB
Growth 50 GB
Scale 200 GB
Storage includes:
- Query result cache
- Uploaded files
- Template attachments
- Agent logs (30 days)
Query History Retention
Plan History Retention
──────────────────────────────────
Starter 30 days
Growth 90 days
Scale 365 days (1 year)
Workflow Limits
Workflow Executions
Per month limits:
- Starter: Workflows not available
- Growth: 1,000 executions/month
- Scale: 10,000 executions/month
Workflow Actions
Per workflow limits:
- Maximum 20 actions per workflow
- Maximum 10 conditions
- Maximum 5 nested levels
- Execution timeout: 5 minutes
Agent Execution Limits
Schedule Frequency
Minimum intervals:
- Growth: Every 15 minutes minimum
- Scale: Every 5 minutes minimum
Agent Timeout
- Maximum execution time: 10 minutes
- Automatic termination after timeout
- Error logged to agent history
Export Limits
CSV/Excel Export
- Maximum 100,000 rows per export
- Maximum file size: 50 MB
- Rate limit: 10 exports per hour
API Data Export
- Pagination required for >1,000 records
- Maximum page size: 1,000
Chat Support Limits
Concurrent Chats
Per agent limits:
- Maximum 5 active chats per agent
- Waiting queue unlimited
- Auto-assignment based on availability
Chat History
- Retained for 90 days
- Export available anytime
- Attachments count toward storage
Monitoring Usage
Usage Dashboard
Navigate to Settings → Usage & Billing to see:
- Current period usage
- Percentage of quota used
- Projected end-of-month usage
- Resource consumption breakdown
- Historical trends
Usage API
GET /api/billing/usage
{
"period_start": "2024-12-01",
"period_end": "2024-12-31",
"queries": {
"used": 7450,
"limit": 10000,
"percentage": 74.5
},
"storage": {
"used_gb": 45.2,
"limit_gb": 50,
"percentage": 90.4
},
"rate_limits": {
"current_window_remaining": 42,
"window_reset_at": "2024-12-10T15:31:00Z"
}
}
Optimization Tips
Reduce Query Usage
- Cache Results: Use saved queries instead of re-running
- Templates: Create templates for repeated queries
- Scheduled Agents: Run reports once, share results
- Filter Early: Narrow queries to reduce processing
Manage Storage
- Clean Old Results: Delete unused query results
- Archive Logs: Export and delete old agent logs
- Compress Files: Compress uploads before storing
- Review Monthly: Audit storage usage
Respect Rate Limits
- Implement Backoff: Exponential backoff on 429 errors
- Batch Requests: Group API calls when possible
- Monitor Headers: Check X-RateLimit-Remaining
- Use Webhooks: Instead of polling
Exceeding Limits
Temporary Overages
Options when exceeding limits:
- Purchase Add-Ons: Buy extra queries/storage
- Upgrade Plan: Move to higher tier
- Wait: Limits reset at start of billing cycle
- Optimize: Clean up to free resources
Soft vs Hard Limits
Soft Limits: Can temporarily exceed with overage charges
- Monthly query quota
- Storage limits
Hard Limits: Cannot exceed
- Concurrent queries
- API rate limits
- Workflow action count
- Export row limits
⚠️ Repeated Limit Violations
Consistently exceeding rate limits may result in temporary throttling or account review.
Enterprise Custom Limits
Need higher limits? Contact sales for:
- Custom query quotas
- Increased rate limits
- Dedicated infrastructure
- SLA guarantees
- White-glove support
💡 Contact Enterprise Sales
For organizations with unique requirements, we offer custom plans. Email: enterprise@datixlab.com