Inline Report Size Limit with URL Failover

  • report.generate and report.synchronous now cap inline (resultStyle: "inline", the default) responses at 10MB of uncompressed report data. A completed report above that limit returns status: "failed" with failureReason: "ReportTooLargeForInline", and reportData carries a short-lived presigned S3 download url plus metadata (the same shape as resultStyle: "url") instead of inline data/columnNames. Fetch that URL to retrieve the data instead of retrying inline.
  • This limit drops from 10MB to 5MB the week of August 17. Reports between 5MB and 10MB that succeed inline today will fail over to the URL shape then, so we recommend requesting resultStyle: "url" as your default: it is not subject to the inline limit, and it serves small and large reports alike.
  • Two things to check before switching to resultStyle: "url". The presigned download is served Content-Encoding: br (Brotli) with no content negotiation, so the client fetching it must decode Brotli. And "Show All" reports whose result is a single aggregate count still respond inline, with data/columnNames and no url, so keep handling the inline shape.
  • Data delivered via reportData.url (including the over-limit failover URL) always includes the header row as the first row. includeHeadersInData affects only inline reportData; it does not change the contents of a URL-delivered payload.