Skip to main content
Version: 0.10

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​

LimitDefaultSettingWhat happens beyond it
Items per page (size) on any list200platformConstants.maxPageSizeServed as 200; the total in data.size is unaffected
Assets named in one bulk edit or bulk delete1000platformConstants.maxBulkAssetIdsRefused. Use the "all matching the query" variant instead
Length of a serialised id list64,000 charactersplatformConstants.maxBulkIdListLengthRefused before it is parsed
Groups returned by one asset aggregation500platformConstants.maxAggregationBuckets (0 for no limit)Refused
Span of a date histogram (one bucket per day)3660 daysplatformConstants.maxDateHistogramDays (0 for no limit)Refused

Uploads​

LimitDefaultSetting
CSV asset import file10 MBfileStorageLimits.csvUploads
Rows in one CSV asset import1000platformConstants.maxCsvImportRows
Excel report template (.xlsx)5 MBfileStorageLimits.reportTemplates
File attached to an asset field10 MB, or the field's own smaller limitfileStorageLimits.assetFieldFiles
User avatar5 MBfileStorageLimits.avatars
Tenant logo5 MBfileStorageLimits.tenantLogos
Organization logo5 MBfileStorageLimits.deploymentLogos
Image dimensions (avatars and logos)4096 pixels per side, 4096 × 3072 pixels in totalFixed
Layout definition256 KBfileStorageLimits.maxLayoutSize
Whole request body, most endpoints16 MBWeb server in front of the API
Whole request body, sensor scan results and isolated-scan files128 MBWeb 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.

TODO

The request body limits come from the reference web-server configuration shipped with the product. Confirm the values of the hosted service.

Reports​

LimitDefaultSetting
Reports waiting or being generated per tenant10platformConstants.maxPendingReportsPerTenant
Automatic deletion of finished reportsOff (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​

LimitDefaultSetting
Tenants per organization1000platformConstants.maxTenantPerDeployment
Integration instances per tenant50Per-tenant setting, default in the backend
Sensors per tenant100Per-tenant setting, default in the backend
Scan schedules per tenant20Per-tenant setting, default in the backend
Fields per tenant500Per-tenant setting, default in the backend
Scan history kept per tenant50 scans (older ones are deleted, never refused)Per-tenant setting, default in the backend
TODO

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​

LimitDefaultSetting
Usable tokens per user20 (expired and revoked ones do not count)platformConstants.apiTokensPerUser
Longest token lifetime365 daysplatformConstants.apiTokenMaxDays
How often last use is recordedAt most once every 60 secondsplatformConstants.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:

WhatCounted perLimitLockoutSettings (platformConstants.)
Failed sign-insEmail address1015 minutesloginMaxAttempts, loginLockoutSeconds
Failed sign-insSource address10015 minutesloginMaxAttemptsPerSource, loginSourceLockoutSeconds
Wrong MFA codesUser515 minutesmfaMaxAttempts, mfaLockoutSeconds
Password reset requestsEmail address51 hourpasswordRecoveryMaxAttempts, passwordRecoveryLockoutSeconds
Sign-upsSource address101 hourregistrationMaxAttemptsPerSource, registrationLockoutSeconds
Invitations to an address that already has an accountInviting user101 hourinviteOccupiedMaxAttempts, inviteOccupiedLockoutSeconds
Confirmation email resendsAccount51 hourconfirmationResendMaxAttempts, confirmationResendLockoutSeconds
CAPTCHA required at sign-in (when configured)Email or source addressAfter 3 failuresn/acaptchaLoginAfterFailures

A locked-out request gets the handled failure "Too many failed attempts. Please try again later". See Account security.

Other values​

LimitDefaultSetting
Password reset link lifetime1 hour, one useplatformConstants.passwordResetTimeoutSeconds
Session lifetimeNo default; set by every deploymentcookieTimeoutSeconds
Email address length2 to 64 charactersFixed
Names of tenants, roles and the organization2 to 64 charactersFixed
DescriptionsUp to 500 charactersFixed
Wizard exclusion reason1 to 1000 charactersFixed

See also​