New Features & Improvements

AI Agent

• New AI models are now available: Gemini 3.1 Pro, Gemini 3.1 Flash Lite, and GPT 5.4.

Admin

• The Merge button in branch review is now disabled with a clear explanation for users who don't have merge permissions.
• Version and project filters in the Enterprise Branch Reviews dashboard are now sorted in alphanumeric and alphabetical order, respectively.
• Enabling MCP no longer requires all API schemas to pass dereferencing validation — the toggle works even if some schemas contain complex $ref structures.

API Explorer

• API Explorer now supports text/csv request body examples.
• Deprecated schema properties are now always visible by default rather than being split into a separate section.

Git Sync

• Enterprise projects now correctly resolve and inherit Reusable Content from their parent project's Git repository, including proper cache invalidation when parent content changes.

MCP

• Hidden and deprecated endpoints now appear as disabled in the MCP routes list.
• Security schemes are now included directly in get-endpoint tool responses — no separate tool call needed.
• Improved descriptions and more structured output for list-endpoints and search-endpoints.
• API definitions containing circular references and OpenAPI webhooks are now fully supported in MCP.

Bugs Eaten (by Owlbert) 🐛

Admin

• Fixed a regression where teammate viewers were unable to access hidden versions.
• Fixed an invisible cursor in the CSS, HTML, and JavaScript code editors when using dark mode.
• Fixed an issue where branch timestamps in the review table all appeared as recently created instead of showing accurate creation and update times.
• Fixed an issue where checkboxes in the Enterprise search project filter would stop responding to clicks after scrolling through a long list.
• Fixed an issue where project names were being truncated in the Enterprise search filter dropdown.
• Fixed an issue where pages with non-ASCII characters (e.g. accented letters) in their slugs would not show diffs in the Review tab.
• Fixed an issue where group editors couldn't see unpublished Recipes they created.

API Explorer

• Fixed an issue where API Designer could create paths without a leading slash, resulting in invalid OpenAPI definitions.
• Fixed an issue where externalDocs links in the API reference were not clickable.
• Fixed an issue where selecting an option in a oneOf/anyOf dropdown would affect other expanded objects sharing circular references.
• Fixed an issue where subschemas were being duplicated in the API Explorer display.
• Fixed an issue where OAuth2 security definitions using OR logic for scope groups were displayed as a flat list — scopes are now correctly grouped.
• Fixed an issue where circular references in response schemas were not displaying correctly.
• Fixed an issue where descriptions and other metadata on circular reference properties were being stripped in the API Explorer request body form.
• Fixed an issue where the OAuth Authorize UI was visible even when the API Explorer was disabled.
• Fixed 404 errors when opening API definitions for editing while on a branch whose name contains a slash.
• Improved cURL snippet generation and reduced payload sizes for LLM endpoints that retrieve OpenAPI definitions.

Docs

• Fixed an issue where parent enterprise Reusable Content blocks were not being expanded in the Markdown view of child projects.
• Fixed an issue where Recipes containing code blocks with triple backticks weren't rendering their steps correctly.
• Fixed a render error in the API Logs Table when switching between pages.
• Fixed an issue where the mobile version selector displayed the version ID instead of any custom display name.
• Fixed an issue where editor menus were not appearing correctly in Firefox.
• Fixed an issue where end-users logged in to private enterprise projects couldn't see those projects in the search filter list.

Docs Audit

• Fixed an issue where the audit schedule modal would get stuck in a loading state for projects that had never set up an audit schedule, preventing first-time configuration.

Bidirectional Sync

• Fixed an issue where merging a branch with "delete branch" enabled would not delete the corresponding branch in GitHub.
• Fixed an issue where API definitions migrated to the new Git-backed system would show as "Unknown spec" in the API Definitions screen until manually resynced — they now correctly display OpenAPI or Swagger on first load.

MCP

• Fixed an issue where path-level common parameters (headers and query params shared across multiple endpoints) weren't being resolved in MCP tool responses.
• Fixed an issue where API schemas without a servers field caused errors in the MCP server.

Your sidebar got a refresh with improved spacing, font weights, accessibility, and visual hierarchy. We've also added collapsible sidebar categories so your users can control navigation density.

Find the option in Admin Settings → Page Settings

---

New Features & Improvements

Docs

• Recipe embeds are now available on API reference pages.
• Autofilling of API endpoint details in Recipes is now supported for all projects.

AI Agent

• Improved the AI Agent’s ability to maintain fresh context.

MCP

• MCP server data now includes schema filenames for better tool context.
• Added compression to the MCP project cache, supporting larger API schemas.

Performance

• Significantly reduced large-project Git sync times.

Bugs Eaten (by Owlbert) 🐛

API Explorer

• Fixed a race condition that caused newly added items in polymorphic array fields to flicker and disappear.
• Eliminated UI flicker when opening accordions in the API Explorer.
• Fixed API reference rendering errors when OAS specs place non-schema objects under components/schemas.
• Fixed long enum values breaking the parameter card layout.
• Fixed the API Explorer scrambling parameter order when editing form fields.
• Fixed a crash when navigating between API reference pages with circular schema references.
• Fixed curl code snippets using --data instead of --data-urlencode for form data requests.

Docs

• Prevented .md file URLs from appearing in Google search results.
• Fixed target="_blank" links incorrectly opening in the same tab when viewing projects with custom JS/CSS.
• Fixed a 404 error when switching API versions from the dropdown on custom pages.
• Fixed custom CSS variables leaking from docs into the admin UI.
• Search results now properly interpolate user-specific variables instead of displaying raw variable syntax.
• Fixed various markdown rendering bugs via engine upgrade.

Editor

• Improved handling of non-conventional variable names in the MDX editor autocomplete.
• Fixed light-on-light text contrast in the MDX editor's JSX code blocks.

AI Agent

• Fixed AI chat slowdown caused by unnecessary re-renders during streaming.
• Fixed the AI Agent displaying the wrong page title during the first edit operation.
• Fixed AI Agent page editing failing when not currently viewing the target page.
• Fixed the AI Agent not including page context in responses.

Admin

• Fixed 500 errors when branch review report scores were null.
• Fixed "last updated" timestamps for branches not reflecting external bi-directional sync changes.
• Fixed auth token refresh during long-running bi-directional syncs.
• Added safeguards to prevent branches from being incorrectly deleted during bi-directional sync.
• Fixed 500 errors when reviewing branches with malformed frontmatter.
• Doubled the request body size limit for large OpenAPI definitions.
• Empty commits are no longer created when content is saved without changes.

MCP

• Fixed MCP cache failures blocking server connections.
• Fixed MCP schemas with identical titles being indistinguishable.

Translations

• Fixed the compact theme language picker not displaying native language names.
• Updated localization strings with professionally translated versions.

The AI Agent now has thumbs up/down response feedback and upgrades to Claude Sonnet 4.5 as the default model. It also gets more reliable page edits with fuzzy matching and automatic retries, plus consolidated thinking steps that collapse reasoning into a single section.

---

New Features & Improvements

AI Agent

• Added thumbs up/down feedback on AI Agent responses so you can rate the quality of answers.
• Default model upgraded to Claude Sonnet 4.5.
• Thinking steps for reasoning models are now consolidated into a single collapsible section.
• Improved the ability of the AI Agent to apply changes with fuzzy matching.
• Linter now includes accurate line numbers in violation results.

API Explorer / Docs

• Accept header, response schema, and response examples now sync together when switching content types.
• New "Auto-fill first request example" setting to optionally prefill request forms with example data.
• "View as Markdown" now expands reusable content and variables.

Admin

• Improved localization for Log In/Out, color scheme dropdown, and search modal.

MCP

• Custom tool names are now validated for uniqueness across enterprise projects.
• Hidden endpoints are properly excluded from MCP servers.
• Fixed spec filtering errors with summary and description fields.

Bugs Eaten (by Owlbert) 🐛

Docs

• Fixed non-latin character page editing.
• Glossary tooltips no longer cause horizontal overflow.
• Recipes with outdated slugs now resolve correctly.
• Emoji now displays properly in the recipes menu.
• Custom redirect rules no longer break with 2-letter path segments.

AI Agent

• Fixed performance issue causing lag and crashes during streaming with large content.
• AskAI dropdown no longer disappears when a project is made public.

API Explorer

• Fixed scroll on API definition pages.
• Enterprise group editors can now view API definitions.

Admin

• Fixed language picker dropdown in compact mode.
• Fixed Appearance tab crash related to recipe display.
• Branch renaming now properly cleans up the old branch.
• Group editors can now edit recipes.

This release brings a major upgrade to the AI Agent with support for multiple chat windows, allowing you to keep different conversation contexts open simultaneously. We’ve also added support for multiple Git connections, giving you more flexibility in how you sync your docs.

---

New Features & Improvements

Admin

• Improved keyword search within the admin UI.
• Enhanced validation for MCP tool titles and improved the saving process on the Teammates page.
• Added support for multiple Git connections.

Docs

• Updated and refined the visual theming for dark mode.

Editor

• Editor blocks now display a preview while being dragged, making layout changes easier.
• Improved error messages when using an invalid OAS security scheme.
• You can now revert changes to Recipes, API Reference pages, and OAS files directly during the review process.
• New changelog posts are now created as hidden by default and will clearly indicate their hidden status in view mode.
• Added support for Font Awesome brand icons.

Translations

• Added support for translating Changelog posts.

Bugs Eaten (by Owlbert) 🐛

Admin

• Fixed a bug that created duplicate endpoints when creating new endpoint pages.
• Fixed an issue where downgrading plans could prevent projects from being published.
• Resolved an issue with the password field on password-protected docs.
• Fixed a bug where the dark mode logo would not update properly after migrating from legacy projects.

AI Agent

• Fixed an issue where the agent failed if content contained extremely long URLs.
• Fixed a bug where the AI Dropdown remained enabled if a project became private.
• Fixed an issue where the Agent did not correctly recognize Components as valid MDX.
• Resolved visibility issues with the model selection dropdown.

Docs

• Fixed issues where enums would auto-populate even if not required, and single-enum boolean values could default to disallowed values.
• Fixed a bug where copying Markdown for LLMs would include the API definition twice.
• Fixed a broken link issue where "View as Markdown" could result in a 404 error.
• Fixed an issue where search appeared twice on mobile views and icons appeared even when disabled.
• Fixed a text wrapping issue with x-enumDescriptions in Safari and a display issue with oneOf options.
• Fixed an issue where the changelog feed would not update instantly for all users.

Docs Audit

• Fixed an issue where audit links could lead to a 404.
• Fixed an issue with sorting pages by the number of broken links.

Doc Metrics

• Fixed an issue with invalid URLs for pages on branches.
• Fixed a bug that inadvertently showed a paywall when not needed.

Editor

• Fixed an issue where duplicating pages did not copy the visibility setting.
• Fixed an issue where missing OAS mappings caused other schemas to be ignored.
• Fixed errors when uploading OAS files with invalid filenames.
• Fixed an issue where it was difficult to place the cursor before the first character in the editor.
• Fixed an issue where certain menus were difficult to access.
• Fixed bugs related to creating second-level nested pages and nesting links with the same name/URL.
• Fixed an issue where Reusable Content overlapped the editor footer.

Translations

• Fixed an issue where the lang property was not being set to the correct language code.

Running a Docs Audit will now automatically check your documentation for broken links, ensuring your users never hit a dead end.

---

New Features & Improvements

Admin

• Added an option to set the default visibility for new pages to either Public or Hidden

Docs

• Added support for polymorphism within additionalProperties
• Added OAS support for parameter.content

Editor

• Added additional <Card /> variant and now wraps responsively

Review

• Teammates with the Viewer role can now view branches, see diffs, and check linter results

Bugs Eaten (by Owlbert) 🐛

Admin

• Fixed an issue with custom domains when downgrading to a plan that doesn’t support them
• Fixed a display bug where custom head HTML could incorrectly appear in the admin UI
• Fixed an issue where cancelling navigation when there are changes could result in lost changes
• Fixed an issue where Ask AI settings changes would not appear in audit logs
• Fixed an issue where uploading API definitions would fail in Linux browsers

API Designer

• Fixed a validation error where defining a tag in multiple places would incorrectly trigger an invalid OAS error

Docs

• Fixed an issue where navigating between sections could cause custom footers to briefly jump to the top of the page
• Fixed an issue with incorrect URLs in the llms.txt file for certain Enterprise projects
• Fixed an issue with navigating to page anchors
• Fixed a header spacing issue for projects without Ask AI enabled
• Fixed a rendering issue with nested discriminators
• Fixed an issue where Changelog RSS feeds were appearing out of order
• Fixed an issue where exact match searches were not correctly highlighting the match in results

Editor

• Fixed an issue where links in Reusable Content were being rewritten
• Fixed a bug where saving to a branch with MDX errors could cause content loss

This update brings smarter search improved relevance across all queries, and enhanced result highlighting. For those times when you need precision, you can now wrap your search query in "quotation marks" to force an exact match search. We’ve also added the ability to schedule Docs Audits on a recurring basis and export the results.

---

New Features & Improvements

Admin

• Projects on ReadMe Refactored can now be cloned.
• Enterprise projects can now set a configurable inactive timeout period before admins are automatically logged out of the Enterprise dashboard.

Ask AI

• Added a new length option, “Unrestricted,” that lets Ask AI determine how long the answer should be.
• Exporting data from Ask AI as a CSV is now available on all plans with the AI Booster pack.
• The input field will now grow as the user types, making it easier to enter more complex prompts.

API Designer

• Added an option to configure the proxy specifically for OAuth requests.
• Improved styling of parameters by providing a clearer, more focused editing UI.

API Reference

• Added breadcrumbs to the API Reference section showing where the page is located within the section.
• Added PKCE support to the Try It Now OAuth flow.

Billing

• Moved the ability to manage your current plan and upgrade to a paid plan in ReadMe Refactored from the legacy dashboard.Smarter S

Auth

• Users with the Editor permission can now see hidden pages.

Bugs Eaten (by Owlbert) 🐛

AI Linting

• Fixed line wrapping when displaying linting rules in Enterprise projects.

Docs Audit

• Improved clarity around the fact that individual Docs Audit scores are clickable.

Editor

• Prevented issues with duplicated pages when attempting to make subsequent edits before the operation was completed.

AI Dropdown

• Fixed an issue with spacing between icons and text.

API Reference

• The “Use Example Value” button now correctly respects parameter types.
• Fixed displaying binary data in example responses.
• Improved performance for pages with large OAS files or a high number of references.
• Fixed syncing OAS files with external references.
• Fixed an issue where pagination in My Requests was not working correctly.
• Fixed an issue where example objects and arrays could end up double-stringified.
• Fixed an issue where the OAuth scope list wasn’t updated when switching between endpoints in different OAS files in the Reference section.

Auth

• Fixed an issue where logos with large heights could push the login form off the screen.
• Fixed an issue where the Password Reset form could crash instead of showing an error message in specific situations.

API Designer

• Fixed issues where multiple parameters could be created with empty names.
• Fixed an issue where undefined schemas caused the designer to error.

ReadMe API

• Improved consistency when handling branch and version names with and without a v prefix.

Documentation

• Fixed an issue where pages linking to headers with non-Latin characters did not scroll correctly.

Recipes

• Fixed an issue where Recipes embedded on pages with large amounts of text could be scrolled out of view.

We’ve added a new style for method badges and a convenient Preview Mode. You can now toggle Preview Mode with Ctrl + . to instantly view your docs exactly as a user would. To update your method badge look, head to Settings → API Reference → Method Badge Style.

---

New Features & Improvements

Admin

• Rolled out a new UI for Manage Team and Manage Plan.

API Designer

• Users can now edit request body examples and custom code samples.

Branches

• Added the option to mark branches as “Ready for Review.”

Docs

• Added a new option to hide method badges entirely.
• Added IDs to endpoint parameters, allowing users to link directly to specific parameters.

Git Sync

• Added support for syncing force pushes.
• Improved error messages when encountering installation issues.

MCP Server

• Added support for private projects.

Bugs Eaten (by Owlbert) 🐛

Admin

• Fixed an issue where certain modals could block the admin UI.
• Fixed a crash that could occur on the dashboard for Enterprise projects.
• Resolved UI glitches regarding duplicate scrollbars and broken links on the Recipes page.

AI Linter

• Fixed an issue where the AI Linter could incorrectly report a check as out-of-date.

Ask AI Dropdown

• Fixed an issue where links to third-party LLMs in the Ask AI dropdown weren’t working.
• Fixed a bug where HTML comments were appearing in Markdown content.

API Designer

• Fixed a bug where removing custom code samples would not update the UI.
• Fixed a display issue with long code examples.

Editor

• Fixed an issue where highlighting to delete a section wasn’t working as expected.
• Fixed a bug where users couldn’t leave the history view when editing Changelog pages.
• Resolved multiple issues with editing lists and JSX inside table cells.
• Fixed an issue where Custom Pages were not validating MDX.
• Fixed an issue where the sidebar could be out of sync
• Fixed an issue where headings in Components and Reusable Content were missing from the Table of Contents.
• Fixed a bug where modifying Reusable Content would strip whitespace from its name.

Docs

• Fixed an issue where stale response examples appeared when navigating to new endpoint pages.
• Resolved multiple issues where search was not accessible on mobile, didn't filter correctly by version on Enterprise, or didn’t take up the full screen.
• Fixed an issue where Cmd + K (open search) wouldn’t work when Ask AI was enabled.
• Fixed an issue where navigating to anchor links would sometimes fail.
• Fixed an issue where the Table of Contents would not stick on scroll in some projects.
• Fixed a bug where the wrong version could be displayed.

Docs Audit

• Fixed an issue where scores were not showing the correct decimal precision.

MCP Server

• Fixed an issue where search and fetch tools weren’t showing up for projects with custom domains.

New Features & Improvements

API Designer

• Added the ability to autogenerate Response Schema from an Example Response.

Bidirectional Sync

• Allowed users to remove their Bidirectional sync connection entirely.

Bugs Eaten (by Owlbert) 🐛

Search

• Fixed an issue where the wrong phrase was sometimes highlighted in search results.
• Fixed an issue where the search API for Enterprise projects on Refactored was returning 500 errors.

MDX

• Prevented the page from being saved if it contains invalid MDX syntax.

Editor Permissions

• Fixed an issue where editors viewing the synced repository information would be switched from edit to view mode.

Docs Audit

• Fixed an issue where multiple docs audits could be accidentally started at the same time.

API Designer

• Added warnings to the API Designer for OpenAPI features that aren't currently supported.
• anyOf and oneOf objects with defaults set will properly render in the API Reference section.
• After syncing an OAS file, the URL used will be remembered for subsequent resyncs.

API Reference

• Fixed an issue with API Reference pages not being indexed by search engines by default.
• Fixed an issue where Node code samples were defaulting to fetch instead of the api module.

a11y

• Several accessibility improvements including:
  • Fixed Header search state that wasn’t visible on very dark backgrounds for the solid theme.
  • Added a missing label to the search dialog.
  • Added missing labels to discussion inputs.
  • Fixed the Jump To and Header buttons not refocusing after closing their respective modals.
  • Added missing aria-expanded props in API Reference.
  • Removed duplicate IDs from API Reference.
  • Fixed an inaccessible tooltip in API Reference auth.
  • Added aria-pressed state for the language picker.
  • Fixed missing labels on feedback buttons.
  • Fixed missing labels on close buttons on all modals.
  • All tooltips now close when pressing the escape key.

MCP

• Fixed an issue where enabling MCP for specific endpoints didn't work if the OAS file was missing operationIds.

AI Agent

• Improved loading state and streaming for AI Agent responses.

llms.txt

• Fixed an issue where the generated URL for enterprise projects was incorrect.

Sitemap.xml

• Fixed an issue where custom pages had the wrong URL in the generated sitemap.

Guides

• Fixed an issue printing pages that are more than one page long.

This week we launched several new features powered by AI to help you create and maintain great documentation more easily.

• AI Linting: Write rules and guidelines about what makes good documentation in plain English that our AI will use to give you feedback on individual docs while they are being written.
• Docs Audit: Run the AI Linter over your entire set of documentation to get an overview of which pages need the most improvement and report on the quality of your docs over time.
• Agent Owlbert: Our own AI Agent with all of the knowledge of how to use ReadMe most effectively. Use it to help you write your content as well as get assistance on ReadMe features.
• New AI Search: We've redesigned our AI Search in the documentation as a conversational interface that understands context, remembers previous questions, and can guide developers through complex implementation scenarios.

You can read more about each of these features in our full launch blog post.

---

New Features & Improvements

API Designer:

• Added support for editing and creating multiple security schemas and setting default security configurations across all endpoints.
• Added the ability to duplicate endpoint pages.

API Reference:

• Added more configuration options for who can view OpenAPI files. Previously, this was limited to only project admins or public access; now project editors and viewers can also be given access.

MCP:

• Added support for using our built-in MCP server for projects using a custom login.

Discussions:

• Added improved support for spam filtering in discussion forum comments.

Bugs Eaten (by Owlbert) 🐛

Search:

• Fixed an issue where searches with no results would sometimes return results containing the section name being filtered.

Editor:

• Fixed an issue where multiple warnings about page size would appear at the same time.
• Fixed some tables that used the pipe character within table cells.

Admin UI:

• Fixed an issue where some modals weren't properly opening in Safari.

The API Designer is now more powerful and easier to use. You can rearrange parameters with a simple drag-and-drop, while also defining more complex and accurate APIs. We've recently introduced fully editable response schemas; added support for advanced structures like arrays, objects in query parameters, and json types; and improved how we render enums.

---

New Features & Improvements

Admin

• Added a new keyboard shortcut (Ctrl + J) to open the admin navigation menu

Docs

• Open Graph images now use your project’s color scheme
• Improved the heading and section hierarchy in API References for better readability

MCP

• Added support for custom tools to be used in your MCP server

Owlbot AI

• Improved indexing reliability for more accurate and timely results
• Increased context limits by 400% to better support larger documentation sets

Bugs Eaten (by Owlbert) 🐛

Admin

• Fixed an issue with relative links not working correctly
• Fixed a bug that occurred when navigating to the Recipes page and switching to edit mode
• Fixed an issue with editing endpoint pages after deleting their definition
• Resolved an issue where owners of Enterprise projects with staging enabled were not receiving emails when end users requested access
• Fixed an issue with changing header styles for some enterprise customers
• Fixed a bug where switching to the "Edit" tab would incorrectly reset page navigation
• Fixed an issue where notifications were not appearing in view mode

AI Agent

• Fixed a bug with the Agent sometimes showing an incorrect diff
• Fixed an issue where the chat input would not display the full content
• Fixed an issue with the Agent failing to edit empty pages

Branches

• Fixed an issue where merging branches could cause a white screen

Docs

• Fixed issues with navigating to custom pages and to specific headings within a page
• Fixed display issues with enums in API References
• Fixed an issue where duplicate boolean values could appear in parameters
• Fixed an issue where date parameters could have slightly different formats
• Fixed an issue where example.com would be displayed when specs were invalid
• Fixed an issue with the response UI handling a large number of examples
• Fixed an issue where custom footers on Recipe pages were not displaying properly

Editor

• Fixed an issue with the Raw Markdown toggle not working as intended
• Fixed an issue with the Make Reusable and Copy actions
• Fixed an issue where notifications could block editor actions
• Fixed an issue with inline links in table cells
• Fixed an issue where the editor would lose focus after saving
• Changing the slug of an endpoint page will no longer show an error message on success

MCP

• Fixed a compatibility issue with MCP inspector tools

Search

• Fixed search issues within password-protected and specific Enterprise project configurations