APIMatic April 9, 2025

This month’s release includes a revamped search experience in API portals for faster content discovery, CLI enhancements that simplify local development for Docs as Code, an MCP Server for OpenAPI validation and support for Single Sign-On (SSO). You’ll also find improved theming, clearer deprecated endpoint visibility and enhancements to our Async Docs as Code API.

💫 Spotlight: API Recipes - Turn Complex API Use Cases into Interactive Tutorials

API Recipes enable you to create interactive, multi-step API tutorials in your API Portal.
This lets developers execute real-world API workflows—including chained requests where one step’s response feeds into the next—directly within the API Documentation.

With API Recipes, you can document virtually any API workflow, guiding developers from exploration to implementation. Each step provides ready-to-use SDK code samples, so after executing a flow, developers can simply copy the code to integrate the entire workflow into their applications.

This means you can transform complex API documentation into interactive, executable examples that dramatically reduce implementation time.

🔗 See the API Recipes documentation to get started.

Enhanced Developer Portal Search

We've introduced a powerful new search capability that transforms how you find information in our API documentation. You can now search across the full content of guides, API endpoints, parameters, and model documentation, enabling you to find exactly what you need more efficiently. This means faster discovery of critical information and reduced time spent hunting for specific details.Search GIF

With this release, you can now perform full-content searches that go beyond document titles, quickly locate API endpoints using operation IDs, easily find parameter and model definitions with detailed searches, and navigate paginated results with a seamless "View More" option.

🔗 Learn more about enabling enhanced search in your API Portal.

 

 Better API Governance with APIMatic's MCP Server for OpenAPI Validation

We've introduced the APIMatic Validator MCP Server, a powerful new tool that helps you enforce API governance checks and ensures your API definitions are optimized for Code Generation.

Key capabilities include:

  • CodeGen-specific validation – Identify and fix issues that impact SDK generation.
  • Enterprise grade API governance – Access APIMatic’s 1200+ validation rules.
  • Ecosystem integration – Works with your favourite MCP-enabled tools like Cursor and Windsurf.
  • Human readable output – Get clear, actionable error messages instead of cryptic warnings.

🔗 See the APIMatic Validator MCP Server GitHub repository for details.

CLI Enhancements for Docs as Code users

We've introduced two major updates to the APIMatic CLI, making it even easier to work with the Docs as Code workflow for API Portal generation.

With this release, you can now:

  • Quickly get started with Docs as Code: New users can create their first API Portal using the new CLI Quickstart guide, which walks through the setup process step by step. Run apimatic portal:quickstart to create your first API Portal.
  • Develop API Portals locally with a built-in Http server – The CLI now includes an HTTP server for local development. With the server’s hot reloading capabilities, you can preview changes instantly without manually rebuilding the API Portal. Run apimatic portal:serve to start a development server.

🔗 Learn more in the CLI reference documentation.

SSO for Enterprise teams

APIMatic now supports Single Sign-On (SSO), enabling users to log in using their organization’s Identity Provider (IdP).

SSO helps teams streamline user management—making it easier to onboard and offboard members while enforcing enterprise authentication policies. It also simplifies the login experience by letting users securely sign in with their existing corporate credentials. 

🔗 SSO is available to all Enterprise customers. Contact us at support@apimatic.io to enable it for your team.

🛠 Improvements

  • API Copilot User Experience: We've enhanced the API Copilot to provide a more seamless chat experience. The input box now responds more quickly during long conversations, eliminating the previous lag between typing and characters appearing. We've also introduced a Dark Theme, giving you a sleek and comfortable visual experience while using the API Copilot.
  • Deprecated Endpoint Visibility: We've enhanced how deprecated endpoints are presented in our documentation, making it easier for you to identify and manage outdated APIs. Our updated interface provides clearer labelling and more intuitive navigation, helping you quickly recognize and avoid using deprecated endpoints.

  • Cosmos Theme: We're excited to introduce the Cosmos Theme, a sleek design that transforms your developer portal with both light and dark mode options. With a cosmic-inspired aesthetic and balanced colour, this theme enhances readability and visual appeal. You can easily activate it through the branding settings in your portal editor or update your theme settings in your APIMATIC-BUILD.json file.
  • Schema sample value generation: Sample values are now automatically generated for numbers and strings based on constraints like minimum/maximum length and patterns when valid examples are not provided. This ensures more accurate and useful sample data in SDKs and documentation.
  • Multi-version API Portals with Async Docs as Code API: The Async Docs as Code API now supports generating API Portals with multiple API versions, enabling better organization and versioning of API documentation. Learn how to structure the build input for multi-version API Portals in APIMatic’s versioning documentation.

🐞 Bug Fixes

  • [Documentation] Untyped objects are no longer automatically converted to the “Object” type in API documentation or SDKs.
  • [PHP] The code parameter is now correctly processed in the authorization URL for the OAuth 2.0 Authorization Code Grant flow.
  • [Documentation] Minor formatting and content issues in SDK README files for Java, TypeScript, Go, and Ruby have been addressed for improved clarity and consistency.
  • [Typescript] Masking header values for logging no longer alters the actual header values. 

📢 Share your feedback

Your feedback makes our product better.

  • 🐞 Found a bug? Report it at support@apimatic.io and earn eternal developer karma
  • 💡 Got a brilliant idea? Schedule a 15-minute chat and share it before our product team claims they thought of it first. 
  • 🎉 Love something we built? Tell us so we can argue less about what to build next

Follow us on LinkedIn to stay updated with the latest news from APIMatic!