Reference
Limits
Token lifetimes, request ceilings, cost caps, and sizes, and which ones an install can change.
These are the limits a developer or an operator can meet, with their values at this release. "Install" in the last column means whoever installs GOAT can change it; "API" means an Admin can, through the settings API; "No" means it is fixed.
Tokens and sign-in
| Limit | Value | Change |
|---|
| Viewer token lifetime | 1 hour by default, at most 24 hours | Per request, with ttlSeconds |
| A person's sign-in | 12 hours from sign-in; refreshing does not extend it | No |
| Viewer tokens per API key | 300 a minute, bursts of 20 | No |
| Token request body | 4 KiB; a larger body is refused 400 BAD_REQUEST | No |
externalUserId | 128 characters, without : or / | No |
Queries
| Limit | Value | Change |
|---|
| Cost cap per query | 10 GiB billed | Install; per dataset on its Settings tab |
| Chart size | Two grouping fields, 10,000 cells | No |
| Chart and metric reads that miss the cache, plus every page of rows and every CSV download | 300 a minute per tenant (or per operator), bursts of 40 | No |
| Filter value lists | 120 a minute, bursts of 20 | No |
| Answer reuse for Live connect and read-in-place datasets | 5 minutes by default | Per dataset |
| Changes reaching viewers (publish, access, suspension, charts) | Within 60 seconds | No |
Every "a minute" ceiling on this page, for tokens and for queries, is kept separately on each Cloud Run instance, so an install running several instances allows that many times the figure. Up to the burst size can arrive at once; after that, requests are let through at the per-minute rate.
Rows behind a chart
| Limit | Value | Change |
|---|
| Rows per page | 1,000 by default; a chart may set 1 to 5,000 | Per chart |
| Rows a viewer can page through | 1,000,000 | No |
| Rows in one CSV download | 100,000 | No |
| Drill levels | 20 | No |
Tenants and access
| Limit | Value | Change |
|---|
| Tenant id | Letters, digits, -, _; starts with a letter or digit; 64 characters, or 200 for a composite id | No |
| Tenant attributes | 20 per tenant. Each key and each value up to 64 bytes, which is fewer than 64 characters when it holds accented or non-Latin letters. | No |
| Tenants per register call | 1,000 | No |
| Rows per sync | 1,000 | No |
| Attribute grants | 100 per install | No |
| Allowed sites | 50, up to 64 characters each | API |
| Values read per dataset when listing tenant ids | 10,000 | No |
Data
| Limit | Value | Change |
|---|
| Uploaded file | 1 GiB | No, at this release |
| Uploads per dataset | 10 GiB in all | No, at this release |
| Files per upload | 100 | No |
| Uploaded file name | 200 characters | No |
| Load jobs kept per dataset | The newest 100 | No |
Lists and bodies
| Limit | Value | Change |
|---|
| Items per page in an API list | Up to 500 | No |
Request body for the admin API (/v5/admin/...) | 1 MiB | No |
The token request has its own 4 KiB limit, above. The push API sets no body limit of its own; Cloud Run's request size limit applies, and a refusal from it does not have GOAT's error shape.
Dashboards
| Limit | Value | Change |
|---|
| Saved versions per dashboard | 10, plus 10 pinned | API |
| Charts on a dashboard | No limit | |