Changelog

20261031 is an opt-in REST API version. 20260709 remains current. Existing managed API keys and OAuth grants retain their resource and scopes.

• Interactive queries: set interactive: true on structured, non-forecast requests to receive the result in the same HTTP response without polling. Queued execution remains the default.
• Execution identity: structured-query responses include execution.mode and execution.execution_id. Interactive responses have no queued-job object or polling URLs.
• Arrow metadata: the IPC schema's admetrics:result entry contains result identity, pagination, requested totals and column metadata, including for empty pages.
• Metric preference: catalog metrics expose comparison_preference for the primary value or point estimate.
• Client currency: client-list and catalog entries expose nullable reporting-default currency; explicit query or output currency takes precedence.
• Usage: interactive executions cost two weighted units by default and share the execution budget with queued requests. Accepted retries, timeouts and failures are chargeable.

Upgrading from 20260709

1. Select /api/20261031 and check the API-Version header. Omit interactive or set it to false to retain queued execution.
2. For interactive requests, supply a finite, authorized reporting-client filter, remove polling options, and use timeout_ms between 1,000 and 120,000. Allow slightly longer in the HTTP client.
3. Read the execution mode and identity. Decode every Arrow record batch and the versioned schema metadata; request totals and column metadata through query options.
4. Use server totals and pagination counts, inspect missing-metric information, and preserve integer precision. Keep separate queries when a KPI intentionally uses different metric filters.
5. Handle unknown comparison preference and null currency. Add bounded retries for throttling, reduce page size for oversized results, and account for each accepted execution.

Queued downloads in this version expire after at most five minutes, or a shorter cache lifetime. An expired download returns 410; a new submission is another execution.

See the complete 20261031 reference and versioned OpenAPI specification for fields, examples, limits and error handling. Returning an integration to 20260709 requires omitting preview-only fields; accrued usage is retained.

20260709 is the current public REST and MCP contract version. MCP discovery now advertises the tool-call names below. Legacy names remain callable as temporary compatibility aliases but are no longer advertised.