NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #3910 most downloaded on npm
See https://github.com/Redocly/redocly-cli
Latest stable
2.77.0
Last release 12 days ago
10 Nov 2026
Ships on a steady schedule
a new release about every 8 days
Nearly every release is documented
notes for 58 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
867 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Fixed an issue where an API alias's root path might be resolved incorrectly for configuration files located outside the root folder.
Fixed an issue where the CLI would fail to run on Windows due to a breaking change in the Node.js API.
struct rule and deprecated the spec rule.
Added the spec ruleset, which enforces compliance with the specifications.join would throw an error when a glob pattern was provided.sourceDescriptions to enforce a valid type field, ensuring compliance with the Arazzo specification.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Clarified usage of the --output option in the bundle command.
--output option in the bundle command.Resolved an issue where overrides for the severity of configurable rules were ignored.
Added the possibility to skip configurable rules using the --skip-rule option.
--skip-rule option.Fixed an issue where valid Redocly tokens were not recognized.
Fixed an issue with the remove-x-internal decorator where bundling API descriptions containing discriminators could fail when using Node.js v17 or ear
remove-x-internal decorator where bundling API descriptions containing discriminators could fail when using Node.js v17 or earlier.Fixed component-name-unique problems to include correct location.
component-name-unique problems to include correct location.remove-x-internal decorator, which was not removing the reference in the corresponding discriminator mapping while removing the original $ref.Updated @redocly/openapi-core to v1.25.9.
Added the REDOCLY_SUPPRESS_UPDATE_NOTICE environment variable so that users can skip version updates.
REDOCLY_SUPPRESS_UPDATE_NOTICE environment variable so that users can skip version updates.--dereferenced option. Previously, references to external files were not substituted with references to components, causing them to become invalid.externalValue as a property name was causing the API description validation process to fail.Removed the support of the x-inherit extension for Arazzo description files.
x-inherit extension for Arazzo description files.Changed the x-operation extension in Arazzo, enabling users to make requests with this extension without an API description file.
x-operation extension in Arazzo, enabling users to make requests with this extension without an API description file.x-parameters extension for Arazzo description files.Fixed an issue where the bundle command did not resolve links in externalValue.
externalValue.Added a warning message to the push and push-status commands to notify users about upcoming or ongoing resource deprecation.
push and push-status commands to notify users about upcoming or ongoing resource deprecation.Updated @redocly/openapi-core to v1.25.3.
Fixed camelCase assertion for single-letter values.
camelCase assertion for single-letter values.Added additional checks to criteria-unique Arazzo rule.
criteria-unique Arazzo rule.Added a cache for resolved plugins to ensure that plugins are only instantiated once during a single execution.
Added Respect and Arazzo rules: no-criteria-xpath, no-actions-type-end, criteria-unique.
no-criteria-xpath, no-actions-type-end, criteria-unique.Fixed a bug where bundling multiple API description files specified as CLI arguments, along with the --output option, stored the result in a single fi
--output option, stored the result in a single file instead of a folder.Added support for the output option in the per-API configuration so that the destination file can be specified in configuration.
output option in the per-API configuration so that the destination file can be specified in configuration.eject command without specifying components, which displays a selectable list of all available components.Updated @redocly/openapi-core to v1.22.1.
Updated the Arazzo validation types for workflows input, parameter objects, and criteria to match the specification.
Updated @redocly/openapi-core to v1.21.1.
Added the eject and translate commands for use with the new Reunite-hosted product family.
eject and translate commands for use with the new Reunite-hosted product family.Get more helpful error messages when there's a problem importing a plugin.
Added support for ESM plugins and importing of plugins directly from npm package: @vendor/package/plugin.js instead of ./node_modules/@vendor/package/
@vendor/package/plugin.js instead of ./node_modules/@vendor/package/plugin.js.info-license-strict rule as a replacement of the info-license-url to support the OpenAPI 3.1 changes to allow identifier or URL license details.Added support for AsyncAPI 3.0 description linting.
patternProperties incorrectly caused linting errors due to a missing PatternProperties node.Allowed the theme.openapi configuration option to accept settings specific to Redoc 2.x and earlier.
theme.openapi configuration option to accept settings specific to Redoc 2.x and earlier.spec rule where dependentSchemas was parsed as an array.
It is now correctly parsed as a map.$refs inside patternProperties.Added support for Arazzo description linting.
additionalItems from OAS 3.0.x typings. This keyword is not supported by the specification.Added JSON Schema draft 2019-09+ validation keyword - dependentRequired.
dependentRequired.Changed resolution process to include extendedTypes and plugins before linting.
contentSchema keyword to parse as a schema instance.Users can run the CLI tool behind a proxy by using HTTP_PROXY or HTTPS_PROXY environment variables to configure the proxy settings.
HTTP_PROXY or HTTPS_PROXY environment variables to configure the proxy settings.Made redocly.yaml validation consistent with the general Redocly config.
redocly.yaml validation consistent with the general Redocly config.no-invalid-media-type-examples, no-invalid-parameter-examples, and no-invalid-schema-examples rules which allowed falsy example values to pass for any schema.Added the ability to exclude some operations or entire paths from the security-defined rule.
security-defined rule.Added support for the linting command to output markdown format.
Updated @redocly/openapi-core to v1.12.2.
Updated @redocly/openapi-core to v1.12.1.
Added return values for the push and push-status commands.
push and push-status commands.Removed additional operations from the join command; use lint and/or bundle for operations such as lint and decorate.
join command; use lint and/or bundle for operations such as lint and decorate.github-actions output format for the lint command to annotate reported problems on files when used in a GitHub Actions workflow.no-invalid-media-type-examples rule externalValue example validation.Added check-config command to validate a Redocly configuration file.
check-config command to validate a Redocly configuration file.Updated license text for date and organization naming accuracy.
Fixed a problem with the preview command crashing on Windows by adding operating system detection for the correct npx executable to use.
preview command crashing on Windows by adding operating system detection for the correct npx executable to use.Reverted "Users can run the CLI tool behind a proxy by using HTTP_PROXY or HTTPS_PROXY environment variables to configure the proxy settings" temporar
Users can run the CLI tool behind a proxy by using HTTP_PROXY or HTTPS_PROXY environment variables to configure the proxy settings.
HTTP_PROXY or HTTPS_PROXY environment variables to configure the proxy settings.Updated @redocly/openapi-core to v1.10.1.
Users can run the CLI tool behind a proxy by using HTTP_PROXY or HTTPS_PROXY environment variables to configure the proxy settings.
HTTP_PROXY or HTTPS_PROXY environment variables to configure the proxy settings.join command so that --prefix-components-with-info-prop replaces spaces with underscores to create less confusing $refs.Adds support for using logical AND for the security schema so that the join command generates the correct schema.
join command generates the correct schema.join command did not process schemas containing null values when the --prefix-components-with-info-prop option was used.'- Removed descriptions adding for x-tagGroups for the join command. Descriptions in x-tagGroups are not supported and cause errors on linting.
join command. Descriptions in x-tagGroups are not supported and cause errors on linting.info.title to be used as a name in x-tagGroups instead of a file name for the join command, so you can now join files with the same names.no-required-schema-properties-undefined rule to check if each required schema property is defined.--prefix-components-with-info-prop option with the join command caused $refs to include duplicated prefixes.$refs ending in # (instead of #/) would break the application.Added markdown format option to stats command for use with GitHub job summaries.
push command, when destination option does not work without specifying it in redocly.yaml.Added git to the docker image, so the push command can use git metadata.
Added a push and push-status command for use with future Redocly products.
push and push-status command for use with future Redocly products.Added a preview command that starts a local preview server for Redocly projects that use products that are currently in a pre-release stage.
preview command that starts a local preview server for Redocly projects that use products that are currently in a pre-release stage.x-codeSamples languages.Deprecated --lint option in the join command. The options are marked for removal in a future release. Use the lint command separately to lint your API…
$ref in the Redocly config file. This ability allows users to split up big config files and maintain their constituent parts independently.--lint option in the join command. The options are marked for removal in a future release. Use the lint command separately to lint your APIs.Deprecated lint-related options in the bundle command. The options are marked for removal in a future release. Use the lint command separately to lint…
array-parameter-serialization to require that serialization parameters style and explode are present on array parameters.bundle command. The options are marked for removal in a future release.
Use the lint command separately to lint your APIs before bundling.Fixed an issue with resolving the node-fetch package by explicitly adding the missing dependency.
node-fetch package by explicitly adding the missing dependency.Added recommended-strict ruleset which uses the same rules as recommended but with the severity level set to error for all rules.
recommended-strict ruleset which uses the same rules as recommended but with the severity level set to error for all rules.split and join commands.--host/-h argument in the preview-docs command is now also used by the WebSocket server for hot reloading.Added the possibility to configure the linting severity level of the configuration file for all CLI commands. Redocly CLI exits with an error if there
error.Fixed an issue with nested refs in the join command.
join command.pattern and notPattern assertions to be more precise.unevaluatedItems type definition to resolve either boolean or object schema per JSON Schema 2019-09 specification.Added support for linting AsyncAPI v2 files, so that a wider range of API descriptions can use the Redocly linting workflow.
One column per quarter.