Changelog
New dated versions ship under /api/<version>; the portal always tracks the latest.
20260709 is the latest 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.
| Previous tool call | 20260709 tool call |
|---|---|
compile_korrelat_question | compile_analytics_question |
run_korrelat_question | run_analytics_question |
run_korrelat_json_query | run_structured_analytics_query |
list_korrelat_clients | list_available_clients |
search_korrelat_catalog | search_analytics_catalog |
search_korrelat_dimension_values | search_dimension_values |
explain_korrelat_query | explain_analytics_query |
open_korrelat_catalog_picker | open_analytics_catalog_picker |
- Initial Developer Portal V1 implementation plan created.
- Portal V1 app implementation started with a modern docs-first design system.
- Public docs, authenticated catalog, Query Builder, token center, and BFF routes are the first scoped surfaces.
Versioning policy
The current public contract uses a dated YYYYMMDD version under /api/<version>. The portal tracks the latest version and advertised MCP tool names from the upstream aggregate OpenAPI document. /v1 remains a deprecated compatibility surface; no removal date has been announced.
Deprecated v1 contract
The complete compatibility contract remains machine-readable at GET /v1/openapi.json. It includes the explicit /v1/questions/*, /v1/korrelat-queries/run, catalog, explain, and MCP bridge paths plus the short /v1/compile, /v1/query, /v1/run, and /v1/query/raw aliases. Every v1 operation is marked deprecated and links to its 20260709 replacement.