Changelog

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.

Fixes

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

Fixes

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

Fixes

• Fixed project analytics collection.

Fixes

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

Fixes

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

Features

• Added ability to fetch and search project branches on the Branch Deploy Strategy page.

Fixes

• Improved JavaScript compilation time on Windows.

Features

• Added batch file support to the push API and preserved backward compatibility with the legacy Scout push API.

Fixes

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

Fixes

• Fixed an issue where Markdoc tags did not render in preview mode.

Features

• Added LLM-related page actions to the GraphQL docs.

• Added dynamic function to @redocly/theme for lazy loading components.

• Improved breadcrumb navigation by refining visual design, shortening long page names, adding dropdown menus for deep structures, suggesting related pages, supporting icons, enabling multilingual translations, and fixing duplicate catalog entries.

• Used the tokenUrl value as the default in each security flow of Try It.

• Added the security section for the @requiresScopes directive in the GraphQL docs.

• Added support for accessing original identity provider tokens.

• Added classic catalog card component to the list of ejectable components.

• Made the codeSamples->languages parameter optional.

• Added support for the x-metadata extension in AsyncAPI documentation.

• Added search to the discriminator dropdown for lists longer than six items.

• Added ability to run workflows, inputs schema for workflows, Arazzo expression highlighting and completion, support for x-security, updated collection tree UI.

• Added Play and WorkflowHierarchy icons.

Fixes

• Fixed broken feedback submission.

• Fixed crash during sidebar generation caused by long folder names.

• Renamed environment variable OAUTH_USE_INTROSPECT to REDOCLY_OAUTH_USE_INTROSPECT.

• Fixed a bug where opening a URL with a trailing slash redirected to a 404 page when path prefix was enabled.

• Updated tooltip design and improved sidebar action button tooltips.

• Fixed incorrect behavior of the environment parameter in the replay-openapi Markdoc component.

• Fixed search results showing RBAC-restricted content from other teams based on block order.

• Skipped creating the search index when search is disabled in the configuration.

• Fixed redirect to be case-insensitive.

• Fixed broken replay-openapi tag when mock server was off.

• Fixed an issue where LLM page actions appeared on pages excluded from search.

• Fixed an issue where code-walkthrough steps did not activate on scroll.

• Fixed mock server returning 404 error when path prefix was enabled.

• Fixed sidebar generation for OpenAPI files named index.yaml.

• Fixed an error caused by using an OpenAPI definition as an index page with a path prefix.

• Fixed login and invite flows for projects with enabled path prefix.

• Fixed logout for projects with one SSO provider.

• Fixed locale fallback in sidebar routing.

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

• Improved build performance by optimizing the last modified computation.

• Fixed an issue where clicking the toggle triggered the code-walkthrough step.

• Fixed deprecated discriminator label in @redocly/openapi-docs.

• Fixed binary, form-data file upload and digest auth flow.

• Fixed overflow in catalog classic rows.

• Fixed size and alignment issues for image icons to ensure consistent display across the UI.

• Fixed img Markdoc tag to be self-closing.

Fixes

• Removed default 30-day date range filter from feedback list. Updated date range presets to span entire days.

Features

• Added automatic spam detection for newly created feedback entries based on content.

Fixes

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

• Fixed login and invite acceptance for projects with enabled path prefixes.

• Fixed uploading organization logos in svg format.