Changelog

Fixes

• Updated @redocly/openapi-core and @redocly/cli to version 2.12.3.

Features

• Added synchronization of reviews and comments from Reunite to external Git providers.

Fixes

• Updated @redocly/ajv to version 8.17.1.

• Updated @redocly/openapi-core and @redocly/cli to version 2.12.1.

Features

• Removed Theme components panel from editor page for unsupported products REDOC, REEF, and REDOC_REEF.

• Fixed product type and version resolution during component ejection in the Theme components panel when package.json specifies a product below the organization’s subscription plan.

Fixes

• Skipped visual review check on external Git providers for pull requests targeting non-default branches.

Fixes

• Fixed an issue where merged pull requests appeared as open for PRO plan subscriptions.

Fixes

• Fixed editor reconnection failures caused by unexpected errors during connection.

• Fixed issue where new files were not backed up to browser storage.

Features

• Fixed an issue where filtering by values containing commas did not work correctly in API requests.

Fixes

• Updated @redocly/openapi-core and @redocly/cli to version 2.11.1.

• Updated @redocly/ajv to version 8.11.4.

Fixes

• Synchronized date range filters between feedback export modal and feedback list.

Features

• Added x-keywords extension support for OpenAPI documents to boost or exclude search terms through keywords.

• Added connect-mcp Markdoc tag.

• Added support for configuring mock server settings at the product level.

• Added Ask AI floating action button to trigger AI Search. Deprecated search.ai config option and replaced it with aiAssistant.

• Added a possibility to send feedback for AI Search responses.

• Added page actions that allow to connect to the MCP server via VSCode and Cursor.

• Added support for discriminator.defaultMapping in OpenAPI 3.2.0.

• Added projectTitle parameter to seo configuration to append project name to page titles.

• Added frontmatterTranslate utility to localize React front matter.

• Added additionalProps to navbar, sidebar, and footer items to enable adding custom properties.

• Added support for anchor links to the tabs Markdoc tag.

• Updated CSS styles for the tag component.

Fixes

• Fixed a path prefix issue for static assets from static directory.

• Fixed an issue where disabling mockServer did not remove its paths.

• Fixed an issue where valid links caused link checker errors for API description file download links.

• Fixed incorrect paths in anchor links when REDOCLY_PREFIX_PATHS was used.

• Fixed an issue where scorecard level rules were not overridden with target rules.

• Fixed an issue where the link checker incorrectly reported links with configured wildcard redirects as broken.

• Fixed navigation issues in sidebar, product, and version pickers for projects using path prefixes.

• Fixed an issue where static assets were served without path prefix when it was enabled.

• Updated @redocly/openapi-core to version 2.10.0.

• Fixed an issue where renaming route paths and changing API functions required full restart in the preview mode.

• Fixed security vulnerability CVE-2025-62610.

• Fixed a conflict in the router between MCP server and file with the same name in the root directory.

• Fixed an issue where API output files listed in the ignore configuration were not excluded.

• Fixed an issue in AsyncAPI docs where schemaFormat with $ref in message payloads caused crashes.

• Fixed an issue where the sidebar didn't preserve its state between reloads.

• Fixed an issue where component ejection failed with npm installations.

• Fixed an issue where search didn't parse Markdoc variables and partials.

• Fixed an issue where URLs in the sitemap didn't respect the path prefix.

• Fixed an issue that caused redirects to not work in locales.

• Fixed card links leading to incorrect locations in GraphQL and AsyncAPI docs.

• Fixed an issue where navigation actions could not be disabled for a page using front matter.

• Fixed an issue where link checker reported HTML a tag valid links in project under path prefix.

• Improved layout of the tabs component.

• Improved AI assistant usability on mobile devices.

• Content slugger no longer takes media assets and ignored files into account.

• Fixed an issue where page actions appeared for each partial Markdoc tag on a page.

• Fixed an issue where oneOf titles were overridden by the parent schema's title.

• Fixed an issue where servers in OpenAPI documentation pages were not inherited from the root server.

• Fixed malformed operation link URL in Replay.

• Updated openapi-sampler from version 1.6.1 to 1.6.2.

• Updated @redocly/openapi-core and @redocly/respect-core to version 2.10.0.

• Changed Ask AI button default icon from redocly to sparkles.

• Fixed an issue where the navbar link to the root ("/") path in projects under path prefix was not active.

• Fixed the Card component missing list bullets and limited Markdown support.

• Improved Download panel height to fit the content size for Graphql docs.

Fixes

• Updated @redocly/openapi-core and @redocly/cli to version 2.10.0.

Fixes

• Updated @redocly/openapi-core and @redocly/cli to version 2.9.0.

Fixes

• Updated @redocly/openapi-core and @redocly/cli to version 2.8.0.

Features

• Improved text color of disabled items in the file context menu.

Fixes

• Fixed file upload for allowed folders with RBAC.

• Updated @redocly/openapi-core and @redocly/cli to version 2.7.0.

• Fixed issue that allowed deletion of protected files from the file tree using keyboard shortcuts.

Fixes

• Fixed an issue where successive sidebar items were not activated when users were scrolling API document pages.

Fixes

• Updated @redocly/openapi-core and @redocly/cli to version 2.5.1.

Fixes

• Updated @redocly/openapi-core and @redocly/cli to version 2.5.0.

Fixes

• Updated @redocly/openapi-core and @redocly/cli to version 2.3.1.

Fixes

• Renamed the get-full-definition MCP tool to get-full-spec-document.

• Fixed visual issue in x-mcp overview section.

Features

• Added front matter keywords configuration to boost or demote search rankings for Markdown pages through includes/excludes lists.

• Added validation for React pages to catch runtime errors during the build process.

• Added openapi.showSchemaCatalogLinks configuration option to display links to schemas and requests on an OpenAPI page. These links can be used as $ref values in other OpenAPI files within the same project.

• Added support for _partials folders at any directory level. Added glob pattern support for the partialsFolders configuration.

• Added showBuiltInScalars and showBuiltInDirectives options to control visibility of built-in GraphQL scalars and directives.

• Added validation to ensure residency starts with http:// or https://.

• Added built-in MCP server to expose API docs to AI assistants.

• Added support for OpenAPI 3.2.0 security updates: deprecated and oauth2MetadataUrl fields, deviceAuthorization flow, and code samples generation for device authorization flow.

• Added support for the OpenAPI 3.2.0 servers.name property.

• Improved memory efficiency when creating search indexes, reducing build failures due to out-of-memory errors on large projects.

• Improved heading anchor ID generation by removing dots and slashes to create cleaner URL fragments.

• Added path prefix support for HTML href attributes.

• Added support to configure Replay with dynamic API data.

• Added support for the x-mcp vendor extension in OpenAPI to render MCP server documentation.

• Added the OpenAPI info object to the useConfigureReplay context.

• Added persistence for user-created environments in Try it between page reloads.

Fixes

• Fixed an issue where environment variables were not resolved inside redocly.yaml when building OpenAPI documents.

• Fixed an issue where tooltips could obscure the parent UI element.

• Fixed responses without parameters not being included in llms.txt.

• Fixed search issue where queries with text enclosed in backticks in API descriptions returned no results.

• Fixed display of active element in code-group tag after page refresh.

• Fixed an issue with displaying multiple active elements in a code-group tag when they had the same names.

• Improved error message for broken sidebar links in front matter.

• Fixed search dialog results being unscrollable on small screens. Fixed advanced search filters overflowing the viewport on small screens.

• Fixed an issue where x-rbac and markdoc did not work in Swagger (Open API 2.0.x) descriptions.

• Improved build logs by separating AI Search and llms.txt messages.

• Fixed an issue where external links in the sidebar appeared as active.

• Added icon option to sidebar separator.

• Fixed an issue that prevented focusing the first section of the API documentation when content was minimal.

• Fixed an issue where following an anchor link did not cause the page to scroll to the target heading.

• Fixed duplicated descriptions in oneOf options.

• Fixed an issue where the AI search icon shrank with long queries; the icon maintains its size and the query text wraps correctly.

• Fixed missing Expand All button in requests using oneOf.

• Fixed an issue with the sidebar active item when using REDOCLY_PREFIX_PATHS and the OpenAPI document was in the root directory.

• Fixed partial tags not rendering correctly when containing schema components such as OpenAPI examples and code samples.

• Fixed security vulnerability CVE-2025-59139 in bodyLimit middleware by upgrading hono to v4.9.7.

• Fixed an issue where the API Catalog displayed only one API from versioned subfolders.

• Fixed replay-openapi Markdoc tag not updating until page refresh.

• Normalized trailing slash handling in SSR to prevent hydration mismatches.

• Fixed double prefixes in image URLs.

• Fixed an issue where the OpenAPI download URLs did not work with the output property if the output path was in the /static/_spec/ directory.

• Fixed an issue where plugins writing data to the files in project interfered with the processing causing link checker errors.

• Removed empty catalog sidebar when no filters were configured.

• Enhanced JsonViewer with controls prop to manage CodeBlock headers; removed hideHeader prop.

• Added handling for special characters in query strings.

• Fixed processing of relative OAuth 2.0 authorization and token URLs during the OAuth flow. Parsed OAuth 2.0 scopes from the API definition and displayed them in the security tab.

Features

• Show user-friendly messages for credential validation failures, missing repositories, and branch errors when interacting with Git providers.