Multi-Page Editing for AI Agent

Introducing multi-page editing for the AI Agent—you can now ask it to read, create, and modify multiple documentation pages in a single conversation. We’ve also made the Agent sidebar resizable, so you can adjust it to fit your workflow.

New Features & Improvements

MCP Server

• Consolidated MCP tools for a cleaner developer experience — security scheme info is now included directly in endpoint responses, and redundant tools have been removed.
• MCP now correctly resolves path-level parameters and handles specs without server definitions.
• Hidden or deprecated endpoints now appear as disabled in the MCP routes list.

Docs

• Added support for text/csv request body examples in the API Explorer.
• externalDocs links in API definitions are now clickable.
• Improved example generation for API definitions using $ref pointers and circular schemas.
• API Explorer schemas with deprecated properties now display those properties by default instead of hiding them behind a toggle.
• OAuth2 security definitions with OR-based scope groups now display properly grouped scopes instead of a flat list.
• Improved spam detection in Discussions.

Enterprise

• Enterprise-level Reusable Content blocks now render correctly in Markdown view for child projects.
• Enterprise projects with legacy Ask AI (Owlbot) enabled now include search and fetch capabilities in their MCP servers.
• Teammate viewers now have access to hidden versions.

Performance

• Improvements to performance for large projects, projects with complex API definitions, Docs Audit, and search queries.

Bugs Eaten (by Owlbert) 🐛

API Reference

• Fixed several display issues related to oneOf, discriminator fields, and polymorphic schemas.
• Fixed a crash when interacting with request examples containing arrays in loosely-typed object schemas.
• Fixed enum values and required parameters with defaults being silently dropped from code snippets when navigating between endpoints.
• Fixed sibling properties being dropped on circular $ref pointers in API definitions.
• Fixed empty required arrays appearing in generated JSON Schema output.

Docs

• Fixed a rendering crash on some projects with HTML tags inside callouts.
• Fixed the sidebar not updating HTTP method badges after uploading a modified OAS spec.
• Fixed external links remaining in search results after being removed.
• Fixed an issue with Reusable Content blocks not being loaded properly.
• Fixed table column header placeholders overflowing into adjacent cells on narrow columns.
• Fixed the API Logs table causing a render error when switching pages.
• Fixed theme color mode not syncing correctly in projects with custom code enabled.
• Fixed the mobile version selector not displaying custom version names.

Admin

• Fixed scheduled Doc Audit email notifications being sent repeatedly when audits fell behind schedule.
• Fixed the Docs Audit schedule modal getting permanently stuck on "Loading schedule" during first-time setup.

Editor

• Fixed branch timestamps showing incorrectly.
• Fixed group editors not being able to view unpublished Recipes they created.
• Fixed editor dropdown menus not appearing properly in Firefox.
• Fixed an issue where categories couldn’t be renamed with case-only changes.
• Fixed the API Designer creating paths without leading slashes, producing invalid OpenAPI definitions.
• Fixed the API Designer overwriting paths in an OpenAPI definition under certain save conditions.
• Fixed pages with non-ASCII slugs (e.g., accented characters) not displaying diffs in the Review tab.
• Fixed Recipes no longer linking to their associated endpoints after reindexing.
• Fixed several API definition upload reliability issues.

Git Sync

• Fixed renamed files reading stale content during bi-directional sync.
• Fixed branches not being deleted on GitHub after merge.
• Fixed enterprise child project cloning failing when parent-level subdomain masking is enabled.