July 2025 Product Highlights - AI-friendly Docs, Pagination, and OpenAPI auto-fixes

With this release, you can make your API documentation AI-ready with automatic llms.txt generation, streamline API Portal development with powerful new CLI commands, and handle paginated responses seamlessly across Java, C#, Ruby, and Python SDKs.

We've also made the API Portal navigation more customizable, added granular auto-fix controls to our VS Code extension, and updated Java SDK publishing to support Sonatype's new Central Portal, ensuring your workflows stay current with industry changes.

Make Your Docs AI-Ready with llms.txt Support

You can now automatically generate llms.txt and llms-full.txt files in your API Portals.

This means tools like GitHub Copilot, ChatGPT, Claude, and Cursor can better understand and interact with your API Documentation.

APIMatic now provides out-of-the-box support for llms.txt, a new web standard designed to make developer documentation accessible to AI assistants. These files are similar to sitemap.xml and robots.txt, but tailored for LLMs, and are generated automatically when using the Docs-as-Code workflow.

🔗 Read the changelog for details.

🚀 New CLI Commands to Build, Serve, and Customise Your API Portal

You can now streamline your Docs-as-Code workflow with a new set of APIMatic CLI commands. With these commands, you can scaffold new projects, create API recipes, generate a table of contents, and preview changes in real-time:

👉 Check out the CLI reference documentation to learn more about these commands.

To install or upgrade the CLI, run the following command:

📦 Java SDK Publishing Updated for Sonatype Central Portal Migration

You can now publish Java SDKs using the new Sonatype Central Portal integration. APIMatic has updated the Java SDK publishing flow to align with Sonatype's retirement of OSSRH on June 30, 2025. Your Java packages now publish directly to the Sonatype Central Portal, ensuring a seamless transition.

🔗 See the changelog for details.

🛠 VS Code Extension Now Supports Auto-Fixing Individual Lint Issues

You can now auto-fix specific rule violations in your API definition either by rule or by instance. This gives you greater control when cleaning up your OpenAPI specifications. With the release of v1.0.4 of the APIMatic VS Code Extension, we've enhanced the auto-fix functionality to support granular fixes:

• ✅ Auto-fix all instances of a specific rule violation
• ✅ Auto-fix a single instance of a rule violation

This feature enables precise issue resolution, letting you fix only what needs fixing.

🔗 Read the changelog for more details.

🧭 Customise Your Developer Portal's Left Navigation Bar

You can now control how your developer portal’s left navigation is structured and displayed.

👉 See the Theme Layout Configuration Reference for full details.

📚 Pagination Support Added to C#, Java, Ruby, and Python SDKs

You can now navigate paginated API responses using a unified, OpenAPI-driven interface in the Java, C#, Ruby and Python SDKs. Configure pagination in your OpenAPI definition using the x-pagination extension. Your SDKs then automatically provide intuitive, language-specific helpers for iterating over data.

👉 Learn more about pagination in SDKs.

🛠 Improvements

• Nullable Field Handling in SDK Code Samples: SDK code samples now display nullable fields with their default or example values properly set to null.
• Enhanced Client Initialisation Code Samples: Getting Started guides now provide comprehensive SDK client initialisation code samples for direct copy-pasting.
• Improved GitHub App Validation Messages: Pull request validation messages now clearly indicate they serve as quality gates for SDK and documentation generation.

🐞 Bug fixes

• API Endpoint Order Preservation: SDKs and API documentation now maintain the exact sequence of endpoints as defined in your source API specification file.

⚠️ Deprecations & Breaking Changes

• [Deprecated] portalSettings.sideMenuTitleBehavior Flag: This flag is deprecated. Migrate to the new theme.layout.sidebar object in your build file.
• [Deprecated] OSSRH Publishing for Java SDKs: Sonatype will retire OSSRH on June 30, 2025. Update your publishing credentials to the new Central Portal user tokens and migrate your pom.xml to use central-publishing-maven-plugin.