Skip to main content

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​

LimitValueChange
Viewer token lifetime1 hour by default, at most 24 hoursPer request, with ttlSeconds
A person's sign-in12 hours from sign-in; refreshing does not extend itNo
Viewer tokens per API key300 a minute, bursts of 20No
Token request body4 KiB; a larger body is refused 400 BAD_REQUESTNo
externalUserId128 characters, without : or /No

Queries​

LimitValueChange
Cost cap per query10 GiB billedInstall; per dataset on its Settings tab
Chart sizeTwo grouping fields, 10,000 cellsNo
Chart and metric reads that miss the cache, plus every page of rows and every CSV download300 a minute per tenant (or per operator), bursts of 40No
Filter value lists120 a minute, bursts of 20No
Answer reuse for Live connect and read-in-place datasets5 minutes by defaultPer dataset
Changes reaching viewers (publish, access, suspension, charts)Within 60 secondsNo

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​

LimitValueChange
Rows per page1,000 by default; a chart may set 1 to 5,000Per chart
Rows a viewer can page through1,000,000No
Rows in one CSV download100,000No
Drill levels20No

Tenants and access​

LimitValueChange
Tenant idLetters, digits, -, _; starts with a letter or digit; 64 characters, or 200 for a composite idNo
Tenant attributes20 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 call1,000No
Rows per sync1,000No
Attribute grants100 per installNo
Allowed sites50, up to 64 characters eachAPI
Values read per dataset when listing tenant ids10,000No

Data​

LimitValueChange
Uploaded file1 GiBNo, at this release
Uploads per dataset10 GiB in allNo, at this release
Files per upload100No
Uploaded file name200 charactersNo
Load jobs kept per datasetThe newest 100No

Lists and bodies​

LimitValueChange
Items per page in an API listUp to 500No
Request body for the admin API (/v5/admin/...)1 MiBNo

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​

LimitValueChange
Saved versions per dashboard10, plus 10 pinnedAPI
Charts on a dashboardNo limit
GOAT documentation

Type to search.