Skip to content

Changelog

Latest releases

Platform
v2026-11-20.3
latest
2026-11-20

Features

  • Added an error notification that appears in the editor when a sync with the default branch fails.

Fixes

  • Fixed an issue where the AI assistant wrote a Markdoc tag in its answer in place of a link, and the page displayed nothing for the tag.

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

  • Fixed an issue where the Platform displayed "Workspace was not found" when GitLab couldn't find the user of a GitLab access token. Fixed an issue where users saw an unexpected error instead of a not-found or access-denied message when a resource was missing in a Git provider or they lacked access to it.

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

AI assistant web component
1.2.0
latest
2026-11-17

Features

  • Added the context option to the AI assistant web component. Use the option to send what the user sees in the host app with each question, such as the current screen or the last error.

  • Updated the AI assistant answers to show their resources as the same bordered tags as the AI search in Redocly projects.

  • Added the needsApproval option to AI assistant web component tools, prompting users to approve actions before they run. The assistant asks the user before it runs such a tool, so a tool that changes data runs only with the user's consent.

Framework
0.140.0
latest
2026-11-04

Features

  • Added McpNotAllowed to the layouts supported by the eject component command.

  • Added support for GitHub alert syntax in Markdown pages: > [!NOTE], > [!TIP], > [!IMPORTANT], > [!WARNING], and > [!CAUTION] render as admonitions.

  • Deprecated the mcp.docs object and moved its options, such as name and ignore, to mcp. Projects that use mcp.docs still build, with a warning in the build log.

  • Added the options attribute to the openapi-code-sample Markdoc tag that overrides the API's openapi configuration for a single embedded code sample. For example, set codeSamples.skipOptionalParameters to true to leave optional headers, query parameters, and cookies out of the sample.

  • Renamed the reunite option and the access.rbac.reunite scope in redocly.yaml to platform and deprecated the old names. Using the old names does not fail the build, but produces warnings in the build log.

  • Changed the Open in Claude and Open in ChatGPT actions of the prompt Markdoc tag to open the desktop apps instead of the web chats. Open in Claude starts a Claude Code session in the Claude desktop app.

  • Improved the design of the prompt Markdoc tag: Copy prompt is the main button, and its menu lists the actions with their icons on the menu button. Without a title configuration, the prompt text appears in the header.

  • Switched Markdoc to @redocly/markdoc, Redocly's fork of Markdoc. Custom tags that import from @markdoc/markdoc keep working.

  • Added menus for selecting allowed enum values and runtime expressions for parameter and form data in the Try it console and Replay.

  • Added the alt attribute to the inline-svg Markdoc tag, which gives the SVG an accessible name for people who use assistive technologies.

Fixes

  • Fixed an issue in Firefox that caused the last message in an AI assistant conversation to overlap the input field when scrolling.

  • Fixed an issue where rbac.content rules for OpenAPI and AsyncAPI description files failed to protect download links with different file extensions.

  • Fixed an issue where an API docs page crashed when an OpenAPI or AsyncAPI description used a boolean schema (true or false) inside an allOf or as a top-level schema, such as payload: true in an AsyncAPI message.

  • Fixed an issue where the Try it console and code samples did not send a parameter declared with content and a JSON media type as one JSON value.

  • Fixed an issue where C# request samples in OpenAPI docs sent number, boolean, and null values from the request body example as strings. C# request samples also compile when the example contains strings with quotes, backslashes, or line breaks, or empty, nested, or mixed-type arrays.

  • Fixed an issue in API docs where content shifted on load when users opened a direct link to an operation or a tag.

  • Fixed an issue where API docs and the json-schema Markdoc tag displayed a false schema as any, or showed the other parts of an allOf that included false. A false schema, a $ref to one, or an allOf that includes one displays as no value allowed, and the parent type label leaves it out.

  • Fixed an issue in API docs where description headings with inline formatting were cut off in the sidebar and in section links. Old section links redirect to the new ones.

  • Fixed an issue that prevented OpenAPI operations from rendering when x-codeSamples contained empty or null items, or when parameters was not a list.

  • Fixed a build failure when an openapi-code-sample Markdoc tag referenced an operation whose x-codeSamples entry had a label but no lang.

  • Fixed an issue where an invalid value in an OpenAPI or AsyncAPI description, such as a server without url or an empty required: in an allOf part, crashed the API docs page. The invalid part is skipped and the rest of the page renders.

  • Improved server-side rendering performance for OpenAPI reference pages with heavily reused schemas.

  • Fixed an issue in OpenAPI docs where request and response samples were empty when a discriminator option's property referenced part of another schema.

  • Fixed an issue where OpenAPI and AsyncAPI pages crashed when an API description set x-badges to a single object instead of a list. The invalid value is ignored and reported in the build log.

  • Fixed keyboard and screen reader issues in the sidebar, Markdoc tabs, switches, select fields, search, and Replay. For example, the arrow keys switch Markdoc tabs without a mouse click first, and the Space key expands sidebar groups and toggles switches.

  • Fixed an issue where a banner with empty content in redocly.yaml displayed the text of the redocly.yaml file instead of being hidden.

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

  • Improved keyboard navigation in catalog entity version history. The arrow keys open the version list and move between versions, the Escape key closes the list, and the focused version shows a focus ring.

  • Fixed an issue where the AI assistant chat jumped to the end of the conversation while a response was streaming, even after the user scrolled up to read earlier messages.

  • Fixed an issue where reaction-specific reasons in page feedback forms did not use the configured labels or components.

  • Fixed an issue where the rating and sentiment page feedback forms accepted invalid email addresses without prompting users to correct them.

  • Improved page feedback forms so that screen readers announce the comment and email fields with their labels.

  • Fixed an issue where the mood page feedback form did not show its reaction-specific default comment label when comment was not configured.

  • Fixed an issue where the sentiment and mood page feedback forms sent the reasons a user selected for one reaction after they switched to another reaction.

  • Fixed the Cancel button in the scale page feedback form so it uses the same translation key as other feedback forms. If you translated feedback.settings.comment.cancel for this button, move that translation to feedback.cancel.

  • Fixed an issue where the top items of the page table of contents were hidden under the navbar when a banner was displayed.

  • Fixed security vulnerabilities GHSA-cg2g-xh64-v4q7, GHSA-mrv2-3pqr-j5jr and GHSA-c6gr-qvv4-5v3f by upgrading dompurify to version 3.4.17.

  • Fixed an issue where the Docs MCP setup snippets gave every site without mcp.name the same server name, which caused a name conflict in the MCP client when users connected more than one site. If mcp.name is not set, the server name is based on the site's domain.

  • Fixed a security vulnerability that could allow a request to the Docs MCP server to consume excessive memory.

  • Fixed security vulnerabilities GHSA-jm63-cq47-j5jp, GHSA-46jr-4wx8-v453 and GHSA-rvq5-wwqv-78pq by upgrading @modelcontextprotocol/server to version 2.3.1.

  • Extended how long MCP clients stay signed in to the authenticated Docs MCP server from 24 hours to 30 days when the identity provider issues refresh tokens. Without refresh tokens, sessions still expire after 24 hours.

  • Fixed security vulnerability GHSA-g3hv-75wg-m249 by upgrading minimatch to version 11.0.3.

  • Fixed an issue where the mock server returned values from earlier requests in later responses.

  • Fixed an issue where the mock server returned a 500 error for requests with a JSON body when the operation declared its response with the */* media type.

  • Improved how fast the mobile menu, search, and other dialogs open on touch devices.

  • Fixed an issue where OIDC login failed with a misleading 400 Invalid JSON error when the identity provider returned an error status or a non-JSON response, such as an "Access Denied" page from a firewall. The login returns a 502 Bad Gateway error, and the server logs show the identity provider host and the HTTP status of its response.

  • Fixed an issue where pages translated with the browser translation feature, such as API docs pages, displayed an error.

  • Fixed an issue where the connect-mcp Markdoc tag displayed a connect button on sites that don't serve an MCP server.

  • Fixed raw HTML in Markdown pages and API descriptions: boolean attributes such as <details open> take effect, and style values that contain semicolons, such as data URLs, are kept.

  • Fixed an issue in the Try it console in OpenAPI docs where the History tab listed requests by path instead of operation name.

  • Fixed an issue in the Try it console where the edited request body was replaced with the documented example when the content type changed. For example, when users switched from JSON to XML and back.

  • Fixed an issue in the Try it request body editor where valid values were flagged as not divisible when the schema's multipleOf was a decimal such as 0.01.

  • Fixed an issue that prevented Try it from sending requests and caused the Security tab to crash when an OAuth2 security scheme had no flows in the API description.

  • Fixed parameter checkboxes in the Try it console and Replay so that the keyboard focus is visible.

  • Fixed an issue where the Try it console and Replay displayed wrong values or did not load when a server, environment, or parameter had a name such as constructor or toString.

  • Fixed an issue that caused array and object query parameters in the Try it console to ignore style and explode settings.

  • Fixed an issue where the project's @theme styles and theme overrides did not load when @redocly/theme was installed inside the product package instead of the project root.

  • Improved page load performance so that pages respond to clicks and taps sooner. The search dialog loads in the background after the page loads, and the code snippet report form loads the first time a user opens it.

  • Fixed keyboard access in select fields: the arrow keys move through the options, Escape closes the list, and a click in a searchable select field lets users type a search right away.

  • Fixed an issue where Visual review in Reunite showed a sign-in redirect loop for login-protected projects in browsers that block third-party cookies, such as Safari, Firefox, and Brave.

  • Improved the security of the Reunite Visual review sign-in for login-protected projects: Reunite no longer passes the session token in the URL.

  • Fixed the AI assistant status lines, such as "Searching documentation..." and "Ran code", that stayed in English on localized sites.

  • Improved how fast the Try it console opens in API docs, especially for operations with many request fields.

  • Fixed security vulnerability GHSA-mrhx-c7xc-m3w5 by upgrading zod to version 4.6.6.

Previous releases

Platform
v2026-11-20.2
2026-11-20

Fixes

  • Fixed an issue where pull request mention suggestions included people without access to the project.

  • Fixed an issue where email notifications about a project might reach organization members without access to it.

  • Fixed an issue where the pull request reviewer list included people who couldn't submit a review and left out organization owners.

  • Fixed an issue where updating a pull request in a project with a GitHub source displayed an error.

  • Fixed the create organization page on Platform for a viewer or a committer of an organization. The page lists the published docs of the projects they can read, each with an "Open" button, and keeps creating a new organization behind a link.

Platform
v2026-11-20.1
2026-11-20

Features

  • Added search to the Platform that finds a setting, page, project, or action by name. Select Search at the top of the sidebar, or press Cmd+K on macOS or Ctrl+K on Windows and Linux.

Fixes

  • Fixed an issue where the AI assistant repeated an API call that needed credentials and answered without the link to add them.

  • Fixed an issue where the access denied page didn't lead back to the project after a Google or Microsoft login to that project.

  • Fixed an issue where the Platform editor sometimes showed "No changes to commit" and no M (Modified) badges in the file tree for unsaved changes after a server restart, until you edited a file or reloaded the page.

  • Fixed an issue where saving the Branches & deployments project settings failed without any message.

Platform
v2026-11-18.4
2026-11-18

Features

  • Added per-project layouts to the Platform editor, so each project keeps its own open tabs and panels.

Fixes

  • Delayed the automatic What's new announcement in the Platform until 7 days after a user signs up. After that, it opens only for announcements published after the user signed up. The What's new list still shows every announcement.

  • Fixed the duplicated "Bot" in author names of commits made by GitHub Apps, such as "Dependabot Bot Bot" in the Platform builds list.

  • Fixed an issue where pull request actions in Platform asked users to check their repository permissions when the Git provider rate-limited the request or couldn't find the pull request.

  • Fixed an issue where the Back button on the access denied page opened Reunite instead of the project. The issue occurred when a single sign-on login to a project failed.

Platform
v2026-11-18.2
2026-11-18

Features

  • Added the Sign-in methods section to the Platform SSO and login page, where organization owners choose whether members sign in to the platform with password, Google, Microsoft, or each of the organization's Corporate identity providers.

Fixes

  • Fixed an issue where projects created with Generate with AI included an unnecessary build folder in the repository and the editor's changes.

  • Fixed an issue in the Platform editor where a failed repository clone showed every file of the branch as a deleted draft.

  • Fixed the pull request timeline of Redocly-hosted projects, which did not show who deleted the branch and closed the pull request.

  • Fixed an issue where the checks on a pull request page in the Platform disappeared while the Git provider was unavailable.

  • Fixed the Analytics card on the project overview page to compare the last 7 full days in UTC with the preceding 7 days, preventing incomplete-day data from understating page views.

Platform
v2026-11-18.1
2026-11-18

Fixes

  • Fixed an issue where the link checker page in the Platform didn't display link warnings from Framework builds, such as links to missing anchors. The page displays warnings together with errors, and warnings don't block publishing.

  • Fixed an issue where editor commits in the Platform failed with a generic error instead of showing the reason a Git provider rejected the push.

Platform
v2026-11-17.2
2026-11-17

Fixes

  • Fixed an issue where the Platform editor sometimes showed an error after a branch rename that succeeded.

Platform
v2026-11-16.5
2026-11-16

Features

  • Added a "Restart" button to a failed Writer run. It starts a new run of the same duty with the same settings. The runs list marks the new run as "Restarted", and its page links to the failed run.

Platform
v2026-11-16.1
2026-11-16

Fixes

  • Fixed an issue where the lint report of a preview deployment in the Platform listed APIs as changed because of later changes on the production branch. The report compares a preview deployment with the production deployment that its branch started from.

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

Platform
v2026-11-13.3
2026-11-13

Fixes

  • Fixed an issue where project creation failed with "Slug does not match required format" when the organization slug started with a digit.

  • Fixed Respect Monitoring runs that stopped before any workflow ran when an Arazzo description used a large local OpenAPI description as a source.

  • Fixed an issue where stopped Respect Monitoring runs displayed a redocly.yaml configuration warning instead of the reason they stopped.

Platform
v2026-11-13.2
2026-11-13

Fixes

  • Fixed an issue where builds and editor syncs failed when the Git server was temporarily unavailable.

Platform
v2026-11-12.3
2026-11-12

Features

  • Added the visitor's teams to the CSV export of AI assistant conversations in Platform project analytics.

  • Added the visitor's teams to AI assistant conversations in Platform project analytics, with a filter by team and a search by user email.

Fixes

  • Fixed an issue that prevented users from returning to a login-protected project after signing out.

Platform
v2026-11-12.2
2026-11-12

Fixes

  • Hardened access control for hosted projects.

Platform
v2026-11-11.2
2026-11-11

Features

  • Added an Answer found filter to AI assistant conversations in Platform project analytics. The filter applies to the conversation list, stats tiles, chart, and CSV export. Rows also display the unanswered question when available.

Platform
v2026-11-10.4
2026-11-10

Features

  • Added question categories to AI assistant conversations in Platform project analytics, with a filter by category. Projects use eight default categories, configurable through aiAssistant.categories in redocly.yaml. Question categories require the Scale or Enterprise plan.

Fixes

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

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

Platform
v2026-11-10.1
2026-11-10

Features

  • Redesigned the Projects page for every organization: a welcome heading, project cards two per row, a New project button in the list header, and dismissible "Get the most out of Redocly" guides below the projects.

Fixes

  • Fixed the "Failed to delete branch" error in the Platform when you deleted a branch that you restored on a merged pull request just after the merge.

  • Fixed an issue in the Platform where a restored branch was removed when the Git provider reported the earlier branch deletion late, for example after you restored the branch on a merged pull request.

  • Fixed the feature picker of the create project with AI form in Reunite: a feature you added yourself, or the OpenAPI Reference added for an uploaded API description, stays selected when the AI suggestions change.

  • Updated the Git provider card on the Reunite organization overview to remove an inaccurate reference to GitOps.

Platform
v2026-11-08.2
2026-11-08

Fixes

  • Fixed an issue where a Reunite organization could be named with a payment card number, which put the number in organization URLs and logs. Organization names and slugs that look like a payment card number are rejected with a validation error.

  • Fixed the Link button in Platform pull request comments to use selected text as the link text and a selected URL as the link target.

  • Improved the custom terms of service editor in Platform organization settings: formatting applies to the word at the cursor, Bold and Italic toggle off existing formatting, and screen readers announce toolbar buttons by name.

Platform
v2026-11-06.6
2026-11-06

Fixes

  • Fixed the "Last updated" date on pages of Framework projects that Reunite builds.

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

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

  • Fixed the Contact support buttons on the deployment summary and publish pages in Reunite to open the AI assistant when the AI assistant is enabled, the same way the Contact support menu item does. Front chat opens otherwise.

  • Fixed Reunite lists restoring cleared filters or removed sorting after reload. Default filters and sorting no longer override URL state, and project menu links include only explicitly selected filters.

  • Fixed continuous data reloading on the Feedback list and project analytics pages in Platform when the selected date range ended today.

Platform
v2026-11-06.2
2026-11-06

Fixes

  • Fixed the editor hanging and disconnecting in projects with very large file trees.

  • Fixed an issue where the Reunite editor sometimes switched to the default branch and showed a "Branch was not found" warning after you renamed the current branch.

  • Fixed an issue where builds from the previous repository remained available after switching a project to another repository, except for the live production build.

  • Fixed incorrect sorting on project analytics details pages and in Reunite feedback exports.

  • Fixed the Redeploy action on the Platform Deployments page, which sometimes stayed on the list instead of opening the new deployment.

  • Fixed Reunite browser tab titles that displayed hyphens from page URLs.

Platform
v2026-11-06.1
2026-11-06

Features

  • Improved Analytics date filters with preset ranges from the last 24 hours to the last 90 days and custom date ranges.

  • Improved tables on the Analytics details pages with rows that load as you scroll and headers that stay visible.

  • Added the mcp.name, mcp.ignore, and mcp.publicEndpoint options to the Redocly platform config editor and marked the mcp.docs options as deprecated.

Fixes

  • Fixed redocly push --wait-for-deployment reporting success when the link checker or scorecard blocked the publish, or when the production deployment failed or did not run.

  • Fixed Slack notifications in Reunite showing a server error when the chosen channel couldn't be used or the Redocly app was removed from Slack. Reunite shows a clear message instead.

Platform
v2026-11-05.3
2026-11-05

Fixes

  • Fixed an issue where the Internal Comment field on the Reunite feedback details page listed invalid reasons for marking feedback as spam.

  • Fixed the Platform editor preview for Realm Plus projects that pin @redocly/realm-plus in package.json. The preview showed a Could not resolve "virtual:realm-runtime" error.

  • Fixed an issue that prevented the Reunite project analytics dashboard from loading when its date range was cleared. Date ranges can no longer be cleared; select another range to change the selected period.

  • Fixed an issue where Reunite lists opened from links with partial filters, such as Feedback, initially displayed results without the default filters.

  • Fixed an issue that prevented Reunite project analytics and other lists from opening when a link contained a malformed date range filter. The filter now falls back to its default.

  • Fixed Respect Monitoring run details opened from a deployment or a pull request check: an expired run shows the retention notice instead of an empty error, and a run stopped by the global timeout shows the timeout error.

Looking for earlier releases? See the archived changelog of Reunite, Realm, Redoc, Revel, and Reef.