API server config
Path: /admin-settings → API Server Config tab
Configure how the API server (TelAPI) instance set scales under load, and how inbound requests are throttled.
General
| Field | Required | Description |
|---|---|---|
| Enabled | Yes | Master toggle for the config. |
Auto-scaling
Same model as Server groups applied to API server instances.
| Field | Required | Default | Description |
|---|---|---|---|
| Scaling Enabled | Yes | false | Master toggle. |
| Min Instances | Yes | 1 | Never scales below. |
| Max Instances | Yes | 10 | Never scales above. |
| Scale Up Threshold | Yes | 0.7 | Utilisation (0 – 1) triggering scale-up. |
| Scale Down Threshold | Yes | 0.3 | Utilisation triggering scale-down. |
| Cooldown Seconds | Yes | 300 | Min wait between actions. |
| Scaling Provider | Yes | — | hetzner / aws / custom. |
| Scaling Config | No | — | Provider-specific JSON. |
Rate limiting
| Field | Required | Default | Description |
|---|---|---|---|
| Rate Limit Enabled | Yes | true | Toggle. |
| Rate Limit Max | Yes | 100 | Max requests per window. |
| Rate Limit Window (ms) | Yes | 60000 | Window length in ms (60 000 = 1 minute). |
| Per API Key | Yes | — | true → per key; false → per source IP. |
When the counter exceeds Max within the window, requests are rejected with 429 Too Many Requests. Counters reset on window expiry.
Daily team limit
This is the platform-wide limit. Teams also have per-team daily limits configured in Users and teams → API Access Configuration.
Workflows
Configure rate limiting
Enable the config → toggle Rate Limit on → set Max + Window → choose Per API Key (recommended) or IP → save.
Enable auto-scaling
Enable the config → toggle Scaling on → set min/max/thresholds/cooldown/provider/config → save.