Limits
These are the limits a script or integration is most likely to meet. Unless
marked fixed, each value is a default that a deployment can change; the
setting name is given for operators of a self-hosted deployment. Settings under
platformConstants and fileStorageLimits belong to the backend
configuration.
Lists and bulk operations
| Limit | Default | Setting | What happens beyond it |
|---|---|---|---|
Items per page (size) on any list | 200 | platformConstants.maxPageSize | Served as 200; the total in data.size is unaffected |
| Assets named in one bulk edit or bulk delete | 1000 | platformConstants.maxBulkAssetIds | Refused. Use the "all matching the query" variant instead |
| Length of a serialised id list | 64,000 characters | platformConstants.maxBulkIdListLength | Refused before it is parsed |
| Groups returned by one asset aggregation | 500 | platformConstants.maxAggregationBuckets (0 for no limit) | Refused |
| Span of a date histogram (one bucket per day) | 3660 days | platformConstants.maxDateHistogramDays (0 for no limit) | Refused |
Uploads
| Limit | Default | Setting |
|---|---|---|
| CSV asset import file | 10 MB | fileStorageLimits.csvUploads |
| Rows in one CSV asset import | 1000 | platformConstants.maxCsvImportRows |
Excel report template (.xlsx) | 5 MB | fileStorageLimits.reportTemplates |
| File attached to an asset field | 10 MB, or the field's own smaller limit | fileStorageLimits.assetFieldFiles |
| User avatar | 5 MB | fileStorageLimits.avatars |
| Tenant logo | 5 MB | fileStorageLimits.tenantLogos |
| Organization logo | 5 MB | fileStorageLimits.deploymentLogos |
| Image dimensions (avatars and logos) | 4096 pixels per side, 4096 × 3072 pixels in total | Fixed |
| Layout definition | 256 KB | fileStorageLimits.maxLayoutSize |
| Whole request body, most endpoints | 16 MB | Web server in front of the API |
| Whole request body, sensor scan results and isolated-scan files | 128 MB | Web server and backend multipart limit |
A file over its own limit gets a handled failure in the envelope. A request body over the web server's limit is refused with HTTP 413 before it reaches the API. A CSV import is all or nothing: every row is checked, and if any row fails, nothing is written.
The request body limits come from the reference web-server configuration shipped with the product. Confirm the values of the hosted service.
Reports
| Limit | Default | Setting |
|---|---|---|
| Reports waiting or being generated per tenant | 10 | platformConstants.maxPendingReportsPerTenant |
| Automatic deletion of finished reports | Off (kept until deleted) | platformConstants.reportRetentionDays (days; 0 keeps them) |
A request beyond the queue limit is refused with a message saying how many are waiting; delete one or wait for one to finish.
Tenants and their contents
| Limit | Default | Setting |
|---|---|---|
| Tenants per organization | 1000 | platformConstants.maxTenantPerDeployment |
| Integration instances per tenant | 50 | Per-tenant setting, default in the backend |
| Sensors per tenant | 100 | Per-tenant setting, default in the backend |
| Scan schedules per tenant | 20 | Per-tenant setting, default in the backend |
| Fields per tenant | 500 | Per-tenant setting, default in the backend |
| Scan history kept per tenant | 50 scans (older ones are deleted, never refused) | Per-tenant setting, default in the backend |
Per-tenant limits are stored with each tenant but no console screen or API endpoint changes them. Document how a customer asks for a different value.
API tokens
| Limit | Default | Setting |
|---|---|---|
| Usable tokens per user | 20 (expired and revoked ones do not count) | platformConstants.apiTokensPerUser |
| Longest token lifetime | 365 days | platformConstants.apiTokenMaxDays |
| How often last use is recorded | At most once every 60 seconds | platformConstants.apiTokenLastUsedGranularitySeconds |
Authentication rate limits
The API has no general request rate limit. The sign-in and account endpoints are limited per key, with a temporary lockout counted from the last attempt:
| What | Counted per | Limit | Lockout | Settings (platformConstants.) |
|---|---|---|---|---|
| Failed sign-ins | Email address | 10 | 15 minutes | loginMaxAttempts, loginLockoutSeconds |
| Failed sign-ins | Source address | 100 | 15 minutes | loginMaxAttemptsPerSource, loginSourceLockoutSeconds |
| Wrong MFA codes | User | 5 | 15 minutes | mfaMaxAttempts, mfaLockoutSeconds |
| Password reset requests | Email address | 5 | 1 hour | passwordRecoveryMaxAttempts, passwordRecoveryLockoutSeconds |
| Sign-ups | Source address | 10 | 1 hour | registrationMaxAttemptsPerSource, registrationLockoutSeconds |
| Invitations to an address that already has an account | Inviting user | 10 | 1 hour | inviteOccupiedMaxAttempts, inviteOccupiedLockoutSeconds |
| Confirmation email resends | Account | 5 | 1 hour | confirmationResendMaxAttempts, confirmationResendLockoutSeconds |
| CAPTCHA required at sign-in (when configured) | Email or source address | After 3 failures | n/a | captchaLoginAfterFailures |
A locked-out request gets the handled failure "Too many failed attempts. Please try again later". See Account security.
Other values
| Limit | Default | Setting |
|---|---|---|
| Password reset link lifetime | 1 hour, one use | platformConstants.passwordResetTimeoutSeconds |
| Session lifetime | No default; set by every deployment | cookieTimeoutSeconds |
| Email address length | 2 to 64 characters | Fixed |
| Names of tenants, roles and the organization | 2 to 64 characters | Fixed |
| Descriptions | Up to 500 characters | Fixed |
| Wizard exclusion reason | 1 to 1000 characters | Fixed |