Error codes
analytics.window_too_wide
The requested `[since, until)` window exceeds the maximum allowed for the chosen `bucket` value.
analytics.window_too_wide is returned at HTTP 400.
When this fires
The /v1/analytics/* time-series endpoints cap the maximum window length per bucket width so any response stays bounded. Smaller buckets carry tighter caps (15m → max 24h, 1h → max 31d, 1d → max 366d). A request whose until - since exceeds the cap for the chosen bucket is rejected before the database scan runs.
What to do
Either narrow the window so it fits inside the cap for the current bucket, or pick a coarser bucket value whose cap covers your window. The error detail names the requested duration, the cap, and the bucket so callers can branch programmatically.
See also
- SDK reference — the Python and TypeScript SDKs raise typed exceptions for codes in this namespace.
- Error code index — every code the runtime can return.