API Reference
Limits
Check workspace limits and current usage.
Limits
Check your workspace limits, feature availability, and current usage against those limits.
Get Workspace Limits
GET
/v1/limitsGet your current tier limits and usage.
Response
{
"data": {
"tier": "pro",
"limits": {
"api_keys": 5,
"assistants": 10,
"documents_per_assistant": 50,
"storage_mb": 5120,
"nerfing_rules": 10,
"requests_per_minute": 60,
"tokens_per_day": 1000000,
"web_search_per_minute": 30,
"file_search_per_minute": 60,
"max_context_tokens": 128000
},
"features": {
"web_search": true,
"file_search": true,
"custom_models": false,
"priority_support": false,
"eu_mode": false,
"sso": false
},
"allowed_models": "all",
"usage": {
"assistants": 3,
"storage_bytes": 52428800,
"storage_mb": 50,
"requests_this_minute": 12,
"tokens_today": 45000,
"requests_today": 350,
"web_search_this_minute": 2,
"file_search_this_minute": 5
}
}
}Response Fields
Limits
Prop
Type
Features
Prop
Type
Example
curl https://api.assistantrouter.com/v1/limits \
-H "Authorization: Bearer $API_KEY"const response = await fetch('https://api.assistantrouter.com/v1/limits', {
headers: {
Authorization: `Bearer ${process.env.API_KEY}`,
},
});
const { data } = await response.json();
// Check if approaching rate limit
const rpmUsage = data.usage.requests_this_minute / data.limits.requests_per_minute;
if (rpmUsage > 0.8) {
console.log('Warning: Approaching rate limit');
}Get Tier Information
GET
/v1/limits/tiersGet information about all available tiers.
Response
{
"data": [
{
"id": "hobby",
"name": "Hobby",
"limits": {
"api_keys": 1,
"assistants": 1,
"documents_per_assistant": 5,
"storage_mb": 100,
"nerfing_rules": 2,
"requests_per_minute": 10,
"tokens_per_day": 100000,
"web_search_per_minute": 0,
"file_search_per_minute": 0,
"max_context_tokens": 8000
},
"features": {
"web_search": false,
"file_search": false,
"custom_models": false,
"priority_support": false,
"eu_mode": false,
"sso": false
},
"allowed_models": "all"
},
{
"id": "pro",
"name": "Pro",
"limits": {...},
"features": {...},
"allowed_models": [...]
},
{
"id": "team",
"name": "Team",
"limits": {...},
"features": {...},
"allowed_models": "all"
},
{
"id": "enterprise",
"name": "Enterprise",
"limits": {...},
"features": {...},
"allowed_models": "all"
}
]
}Tier information is cached for 24 hours as it rarely changes.
Tier Comparison
| Feature | Hobby | Pro | Team | Enterprise |
|---|---|---|---|---|
| Assistants | 1 | 10 | Unlimited | Unlimited |
| API Keys | 1 | 5 | 20 | Unlimited |
| Requests/min | 10 | 60 | 300 | Unlimited |
| Tokens/day | 100K | 1M | Unlimited | Unlimited |
| Web Search | No | Yes | Yes | Yes |
| RAG/File Search | No | Yes | Yes | Yes |
| Storage | 100MB | 5GB | 50GB | Unlimited |
| EU Mode | No | No | Yes | Yes |
| SSO | No | No | No | Yes |
Understanding Limits
Unlimited Values
A value of -1 indicates no limit. For example, tokens_per_day: -1 means unlimited daily tokens.
Feature Flags
Boolean features determine what capabilities are available:
false- Feature is not available on your tiertrue- Feature is available
Allowed Models
All tiers return "all" indicating all models are available to all users.
When you exceed a limit, the API returns a tier_limit_exceeded error. Upgrade your plan or wait for limits to reset.