Ask AI v2 + New Search Experience + MCP Metrics

Ask AI has a new engine and a new home in your docs. Ask AI v2 gives cited answers and can be tuned with custom prompts for tone, length, and structure. We also have a new search experience with a refreshed design and the option to embed Ask AI directly in the search modal. And MCP Metrics is out now for all customers; see tool calls, top clients, error rates, and more!

New Features & Improvements

Docs

Adding x-readme.apply-endpoint-order: true to an API definition syncs endpoint order from the spec on your next upload.
AI agents that request /recipes.md or /changelog.md directly are now redirected to the matching llms.txt file.
Ask AI v2
- New placement options. Floating at bottom & embedded in search.
- Will now use tool calls to better answer your users’ questions.
- Added Custom Prompt support.
- Ability to automatically use the latest recommended models from OpenAI, Anthropic, or Gemini.
- Added inline source links and sources in the footer of each response.
MCP Analytics
- Tracking for Toolcalls, error rate, response time, top clients and more
- Added support for Group level Analytics
Search
- New options for search: Classic and Modern. Modern combines Ask AI and search into a unified UI.
- Classic search results now show a hit count on each section tab.

Editor

The editor now has a heading navigator for jumping between sections on longer pages.
The editor's sidebar navigation is now resizable.
Renaming a page’s URL slug now gives the option to create a redirect, instead of always adding one automatically.
Branches can now be rebased from their parent version.
Branches with merge conflicts will have the option to resolve conflicts in ReadMe.

Enterprise

Audit logs now include diffs for more settings changes.

Bugs Eaten (by Owlbert) 🐛

API Reference

Webhook pages now only include the parts of the OpenAPI definition needed for their own operation.
Discriminator schemas using allOf no longer lose their variant options when part of the definition is reduced or pruned.

Docs

PDF exports no longer reset page numbers after the table of contents or at each chunk boundary in larger projects.
Saving a page no longer fails when its guide category's title contains an ampersand or other special character.

Editor

Fixed long code or HTML blocks losing their syntax highlighting when scrolled sideways, and causing runaway re-renders that could slow down typing.
Fixed Reusable Content blocks referenced on a page failing to resolve once a project has more than 100 custom blocks.
Images in the editor can be dragged and reordered again.
Inline images surrounded by text no longer break onto their own line and split the paragraph.

Git Sync

The public branch share link no longer flickers while it loads.
Fixed resyncing an OpenAPI definition with tag-based reorganization enabled not updating a tag's category title and description when that category was originally created from an untagged endpoint's path.

Enterprise

Enterprise metrics no longer lose their project selections when switching the Project filter and back.
Fixed a bug where editing a child project's glossary copied inherited group terms into it, and where deleting the last term in a group glossary didn't persist after reloading.
Server-side page views now report at the same path as the client, fixing duplicate rows in CSV exports on enterprise and versioned projects.

MCP

The MCP server card now advertises when a password is required to connect.

Ask AI and MCP answers now include the content of any Reusable Content block referenced on the page.

Translations

Table cells containing multiple blocks, glossary terms, or other inline components no longer run together or fail to render after translation.
A stuck translation run no longer blocks that language's branch indefinitely; it's now automatically abandoned after a timeout.
Navigation section names now respect your "do not translate" word list.