Skip to main content
Swagger
All documentation pages

Version 2.12

2.12.1 - August 27, 2025

This is a mandatory release, which means it cannot be skipped when upgrading to a higher version.

  • Bitnami fix:

  • For existing cluster installations, the KOTS admin must be updated to version 1.126.0 or later to install this release.

  • For embedded installations, the kURL installer bound to this release is: curl -sSL https://kurl.sh/4b890f2 | sudo bash.

2.12 - July 31, 2025

This is a mandatory release, which means it cannot be skipped when upgrading to a higher version.

  • AI-supported API design:

    • We have introduced AI, enabling you to create or modify your APIs with the support of AI features. See the Design with AI documentation for details.
  • Draft Mode:

    • We have introduced a new mode supporting API design. You can now create and modify your APIs as drafts before saving them - while still benefiting from access to features such as Form Editor, validation of standardization rules, or import and export options.

      See the Draft Editor documentation for details.

  • Commenting in AsyncAPI:

    • We have added support for commenting in AsyncAPI definitions. See the Comments documentation for details.
  • User Management API updates:

    • Get organization members endpoint has been updated to show each user’s last activity with its date and time, including Read activity.

    • Get user roles endpoint returns a list of roles a specific user has been assigned for each resource in the organization.

    • Get resource types endpoint allows you to display a list of all types of resources in the organization.

    • List all users endpoint allows customers to list all users in their On-premise environment.

    • See the User Management API documentation for details.

  • Maintenance operation command updates:

    • The updated set-default-org maintenance command does not require an admin password.

    • The updated list-users maintenance command allows you to filter the output.

    • The new change-admin-user maintenance command allows you to modify the assigned admin account.

  • Swagger Portal updates:

    • Product templates - streamline creating new products and maintain consistency across documentation.

    • New CK Editor experience - the new HTML-based editor. The portals created after today will only have access to the new editor. Existing portals can choose between the type of page they want to create.

    • Improved Search - you can refine you API search results by categories such as APIs, Endpoints, Pages, and Models to navigate to specific resources more efficiently.

  • Changes to Swagger Studio plans:

    • As a security measure, it is no longer possible to create APIs under a personal account - all new API definitions should be created under an organization.

      The APIs previously assigned to personal accounts are now accessible in the new personal-migrated organization. Their owners will continue to have editing rights as Collaborators.

  • Component updates:

    • Updated KOTS to version: 1.125.X.

    • Updated Postgres to version: 14.15.

    • Updated Swagger UI to version: 5.25.2.

    • Updated Swagger Codegen v3 to version: 3.0.71.

    • Updated Swagger Editor to version: 4.14.6.

    • Updated Swagger Editor Alpha to version: 5.0.0-alpha.149.

    • Updated Virtserver to version: 3.28.

  • kURL installer:curl -sSL https://kurl.sh/swaggerhub-2-12-0 | sudo bash

Was this page helpful?