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
Last release today
17 Sep 2026
Ships on a steady schedule
a new release about every 8 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
757 releases · first in 2020
One column per quarter.
Updated @redocly/openapi-core to v2.28.1.
Updated @redocly/openapi-core to v2.28.0.
remove-unused-components decorator to the post-bundle phase so that components that become unused only after $ref resolution are correctly removed.defaultMapping property was not resolved when bundling.remove-unused-components decorator to the post-bundle phase so that components that become unused only after $ref resolution are correctly removed.defaultMapping property was not resolved when bundling.Updated @redocly/openapi-core to v2.27.1.
Fixed an issue where --component-renaming-conflicts-severity ignored conflicts when different files had components with the same name but different content.
Warning: Autogenrated component names and $ref paths in bundled documents may differ from older releases.
Fixed an issue where --component-renaming-conflicts-severity ignored conflicts when different files had components with the same name but different content.
Warning: Autogenrated component names and $ref paths in bundled documents may differ from older releases.
Updated @redocly/openapi-core to v2.27.1.
Updated @redocly/openapi-core to v2.27.0.
junit output in the scorecard-classic command.lint behavior with the --generate-ignore-file option.
Now lint updates only the entries related to the file being linted.
Other files' entries are unchanged.Updated @redocly/openapi-core to v2.26.0.
excludedPaths option to the no-http-verbs-in-paths rule, allowing specific paths to be excluded from evaluation.no-required-schema-properties-undefined rule to report when a required property is not defined in every oneOf/anyOf branch.excludedPaths option to the no-http-verbs-in-paths rule, allowing specific paths to be excluded from evaluation.no-required-schema-properties-undefined rule to report when a required property is not defined in every oneOf/anyOf branch.Updated @redocly/openapi-core to v2.25.4.
Handled content type wildcards in response validation to improve Respect's accuracy when matching described content types.
spec-discriminator-defaultMapping rule that could cause crashes or incorrect validation results.
The rule now correctly resolves existing schema names, traverses composite schemas (allOf, anyOf, oneOf) to find required properties, treats defaultMapping values as $refs to schemas, resolves $refs correctly across files, and handles cyclic schema dependencies.spec-discriminator-defaultMapping rule that could cause crashes or incorrect validation results.
The rule now correctly resolves existing schema names, traverses composite schemas (allOf, anyOf, oneOf) to find required properties, treats defaultMapping values as $refs to schemas, resolves $refs correctly across files, and handles cyclic schema dependencies.Updated picomatch dependency to ^4.0.4.
picomatch dependency to ^4.0.4.@redocly/config to v0.45.0.extends array in redocly.yaml inside scorecard/scorecardClassic.
Fixed a crash when reference could not be resolved in extends.picomatch dependency to ^4.0.4.Updated @redocly/openapi-core to v2.25.1.
--extends option was provided.Updated @redocly/openapi-core to v2.25.0.
no-mixed-number-range-constraints rule for OpenAPI 3.1+, as well as for AsyncAPI and Arazzo.
This rule warns when schemas use both maximum and exclusiveMaximum or both minimum and exclusiveMinimum keywords.no-mixed-number-range-constraints rule for OpenAPI 3.1+, as well as for AsyncAPI and Arazzo.
This rule warns when schemas use both maximum and exclusiveMaximum or both minimum and exclusiveMinimum keywords.Updated @redocly/openapi-core to v2.24.1.
undici to resolve an issue where formData was being submitted empty.Added x-allowReserved extension for Respect. This extension enables the use of unencoded reserved characters in query parameter values in Arazzo workf
x-allowReserved extension for Respect.
This extension enables the use of unencoded reserved characters in query parameter values in Arazzo workflows.Updated @redocly/openapi-core to v2.23.0.
targets property in scorecardClassic.
Use this property to override scorecardClassic rules for a specific API.Updated @redocly/openapi-core to v2.22.1.
undici to the 6.24.1 version to ensure improved performance, security, and compatibility.Updated @redocly/openapi-core to v2.22.0.
nonEmpty assertion to support arrays.
An empty array is now treated as empty during linting.checkstyle format for scorecard-classic command.nonEmpty assertion to support arrays.
An empty array is now treated as empty during linting.Updated @redocly/openapi-core to v2.21.1.
.redocly.com domain only.join --prefix-components-with-info-prop would incorrectly rewrite discriminator mapping refs.
This issue occurred when schema names contained the same substring as the prefix.Updated @redocly/openapi-core to v2.21.0.
filter-in decorator, allowing to filter through specific target nodes (PathItem or Operation).filter-out decorator, allowing to filter through specific target nodes (PathItem or Operation).filter-in decorator, allowing to filter through specific target nodes (PathItem or Operation).filter-out decorator, allowing to filter through specific target nodes (PathItem or Operation).NO_PROXY environment variable.Updated @redocly/openapi-core to v2.20.5.
Updated @redocly/openapi-core to v2.20.4.
$ref is not used in the path.$ref is not used in the path.Updated openapi-sampler dependency to v1.7.1.
openapi-sampler dependency to v1.7.1.Updated @redocly/openapi-core to v2.20.2.
@redocly/config to v0.44.0.Updated @redocly/ajv to v8.18.0
@redocly/ajv to v8.18.0@redocly/ajv to v8.18.0Updated @redocly/openapi-core to v2.20.0.
Updated @redocly/openapi-core to v2.19.2.
scorecardClassic configurations were not resolved.scorecardClassic configurations were not resolved.Fixed an issue in Respect where only the last value for repeated keys in multipart/form-data request bodies was shown.
multipart/form-data request bodies was shown.Resolved an issue in Respect where the response list with nested object was not correctly assigned to the output.
spec-querystring-parameters rule (OpenAPI 3.2).
This rule enforces that query and querystring are not mixed in the same operation/path parameter set, and that at most one querystring parameter is declared per operation or path.spec-querystring-parameters rule (OpenAPI 3.2).
This rule enforces that query and querystring are not mixed in the same operation/path parameter set, and that at most one querystring parameter is declared per operation or path.Updated @redocly/openapi-core to v2.18.2.
Updated @redocly/ajv to v8.17.4.
@redocly/ajv to v8.17.4.@redocly/ajv to v8.17.4.required with readOnly or writeOnly properties would incorrectly generate warnings.required with readOnly or writeOnly properties would incorrectly generate warnings.Updated @redocly/openapi-core to v2.18.0.
lintEntityWithScorecardLevel function to validate entity files against scorecard level configurations and lintSchema function to lint individual schemas from API description files.Added new outputs-defined Arazzo rule, ensuring outputs are defined before use.
outputs-defined Arazzo rule, ensuring outputs are defined before use.outputs-defined Arazzo rule, ensuring outputs are defined before use.Redirected bundling problems (such as lint errors and warnings) to stderr instead of stdout to avoid interfering with the bundled output.
stderr instead of stdout to avoid interfering with the bundled output.--component-renaming-conflicts-severity option for the bundle command to control how naming conflicts are reported when bundling API descriptions with external references.stderr instead of stdout to avoid interfering with the bundled output.--component-renaming-conflicts-severity option for the bundle command to control how naming conflicts are reported when bundling API descriptions with external references.stderr instead of stdout to avoid interfering with the bundled output.Updated @redocly/openapi-core to v2.15.2.
Updated @redocly/openapi-core to v2.15.1.
description and documentationLink properties to NodeTypes.
Renamed Redocly configuration types to better reflect their purpose and relations.Added support for runtime expressions in the url property of the Respect x-operation extension.
url property of the Respect x-operation extension..redocly.lint-ignore.yaml was not loaded in browser environments.chokidar dependency.Revert: fixed an issue where .redocly.lint-ignore.yaml was not loaded in browser environments.
.redocly.lint-ignore.yaml was not loaded in browser environments.Updated @redocly/openapi-core to v2.14.8.
x-query operations names in OpenAPI 3.0 and 3.1 similar to query in OpenAPI 3.2.Updated @redocly/openapi-core to v2.14.7.
no-invalid-media-type-examples, no-invalid-parameter-examples, and no-invalid-schema-examples would not trigger warnings when an example defined in a schema.Updated @redocly/openapi-core to v2.14.6.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →