Skip to content

Changelog

INFO

This is the platform's version history — a technical summary of what changed in API-dex itself, release by release. Looking for announcements your own organization publishes inside the portal (custom notices, tenant updates)? See Release notes instead — that page explains where to find those in the product UI.

Entries are grouped by minor version and combine changes from both the portal (frontend) and the platform API (backend). Only user-facing changes are listed — internal refactors, test suites, and pipeline/CI work are omitted.

Unreleased

Translated specifications

  • Producers can attach locale overlays (OpenAPI Overlay 1.x) when publishing a spec in the portal or with apidex-cli upload-spec. The uploaded document stays canonical; translations apply when a visitor reads the spec in another portal language.
  • If an overlay cannot be applied, the portal still shows the canonical spec and a warning. Download follows the language on screen.
  • A new spec version that would drop published overlay locales is refused (portal and CLI). --force does not bypass that. A failed category overlay upload rolls back the new category spec (and can cascade products that inherit that spec).

3.1.0

Accessibility

  • Reworked core UI components (buttons, form fields, checkboxes, radios, selects, dialogs, tabs, tables) to meet WCAG 2.2 Level A — full keyboard operability, screen-reader labelling, and visible focus states across the portal.

Environments & access

  • Admins can now restrict which roles may access a given environment, independent of team or application permissions.
  • Sharing an application is now restricted to application owners and portal admins; the share dialog explains this instead of showing a "consumed" column.
  • Fixed a flicker/flash of "no environment access" that could briefly appear on login or page refresh before access finished loading.

Applications & credentials

  • Application credential cards show a hint tooltip explaining credential checks, and support one-click copy to clipboard.
  • Apigee environments: improved the authentication-method picker and added a Workload Identity Federation (WIF) toggle with a confirmation step (you're warned before WIF removes existing credentials).

API specs

  • Uploading an unsupported or invalid OpenAPI spec now returns a clear, readable error message instead of a raw technical one.

External developer portal

  • Public page search now works for anonymous (logged-out) visitors.

3.0.x (3.0.0 – 3.0.2)

This was a major visual and structural redesign of the portal.

Design refresh

  • Replaced the underlying UI framework (Vuetify) with a new in-house component library — buttons, cards, data tables, dialogs, forms, and navigation all redesigned for a more consistent look and better performance.
  • New customizable theming: color presets, and code-editor (Monaco) theme customization for organizations that want to match their own branding.
  • Multi-client visual identities (e.g. for Gastat, Belastingdienst) so the same portal can present differently per organization.

Onboarding

  • New guided walkthrough/tour that helps first-time users create their first application, including an inline example request.

Analytics

  • Redesigned analytics dashboard: time-range selection, trend indicators on KPI cards, and the ability to reset filters. Selected filters are now reflected in the page URL so they survive a refresh or can be shared.

API version comparison

  • Replaced the old "changelog" feature on API specs with a clearer Compare versions view: pick two spec versions and see a structured, side-by-side diff of what changed between them.

Subscription/company management

  • New module for managing companies and their subscriptions (where enabled for your organization).

Email

  • Notification emails now use branded HTML templates.

Platform changes

  • API catalog no longer supports the SAP gateway platform.
  • The backend now starts up gracefully if its database isn't reachable yet, instead of crashing — improving reliability during deploys.
  • Sensitive values are now redacted from application logs.
  • Fixed (3.0.1): a bug where a disabled module could still appear as a clickable link in the sidebar.

Earlier versions

For platform history before 3.0.0, ask a portal administrator or check your organization's internal release archive — this changelog starts at the most recent major redesign to stay focused and readable.