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 9 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 secrets masking did not cover encoded secrets in har-output.
har-output.Updated @redocly/openapi-core to v2.43.2.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Updated @redocly/openapi-core to v2.43.1.
skipPluginEval to keep extends unresolved instead of failing when the config extends a plugin preset.Updated @redocly/openapi-core to v2.43.0.
skipPluginEval option to loadConfig that resolves plugin paths without importing or executing plugin code — the returned plugins contain only their absolutePath.Updated @redocly/openapi-core to v2.42.0.
generate-client command that generates a typed, zero-dependency TypeScript client from an OpenAPI description — auth, retries, middleware, typed SSE streaming, pagination, and multipart included — plus optional companion generators for Zod validation, TanStack Query and SWR hooks, MSW mocks, and date transformers.
See the generate-client command reference and the Use the generated client guide.generate-client command that generates a typed, zero-dependency TypeScript client from an OpenAPI description — auth, retries, middleware, typed SSE streaming, pagination, and multipart included — plus optional companion generators for Zod validation, TanStack Query and SWR hooks, MSW mocks, and date transformers.
See the generate-client command reference and the Use the generated client guide.Added support for the Arazzo spec-compliant workflow reference form $sourceDescriptions. . in dependsOn, step workflowId, and success/failure action w
Added support for the Arazzo spec-compliant workflow reference form $sourceDescriptions.<name>.<workflowId> in dependsOn, step workflowId, and success/failure action workflowId.
Unresolvable workflow references fail only the affected workflow with a clear error message, and no longer abort the whole run or pass unnoticed.
Updated @redocly/openapi-core to v2.41.2.
5.2.1 to 5.2.2 to resolve a vulnerability in YAML parsing.Updated js-yaml from 5.2.1 to 5.2.2 to resolve a vulnerability in YAML parsing.
Added support for the Arazzo spec-compliant workflow reference form $sourceDescriptions.<name>.<workflowId> in dependsOn, step workflowId, and success/failure action workflowId.
Unresolvable workflow references fail only the affected workflow with a clear error message, and no longer abort the whole run or pass unnoticed.
Updated @redocly/openapi-core to v2.41.2.
Updated @redocly/respect-core to v2.41.2.
Updated @redocly/openapi-core to v2.41.1.
drift command's schema-consistency rule reported false-positive findings for oneOf schemas with a discriminator.
Payloads are validated only against the branch selected by the discriminator value instead of every oneOf branch.
Schemas whose discriminator does not meet Ajv's structural requirements keep the previous behavior.drift command's built-in undocumented-header ignore list with x-amz-, x-amzn- and x-github- prefixes, and the x-hub-signature / x-hub-signature-256 webhook signature headers.Fixed an issue in respect where the execution of parent workflow's steps didn't halt after a step that referenced another workflow had failed.
respect where the execution of parent workflow's steps didn't halt after a step that referenced another workflow had failed.security-scopes-defined that requires every scope used in a security requirement to be defined in the corresponding OAuth2 security scheme.
The rule supports OpenAPI 2.0/3.x and AsyncAPI 2.6/3.0, suggests the closest defined scope for typos, and has an opt-in requireScopes option that requires OAuth2 security requirements to list at least one scope.security-scopes-defined that requires every scope used in a security requirement to be defined in the corresponding OAuth2 security scheme.
The rule supports OpenAPI 2.0/3.x and AsyncAPI 2.6/3.0, suggests the closest defined scope for typos, and has an opt-in requireScopes option that requires OAuth2 security requirements to list at least one scope.respect where the execution of parent workflow's steps didn't halt after a step that referenced another workflow had failed.cursor AI provider of the generate-spec command sent only the instructions to the model and the operation to refine never reached it.Updated @redocly/openapi-core to v2.40.0.
dataValue field.Updated @redocly/config to v0.52.0.
Updated js-yaml from 4.2.0 to 5.2.1.
Fixed an issue where strings that look like numbers with underscores (for example '12_34') had quotation marks removed by the bundle command.
These strings stay quoted in the output.
Note: YAML parsing is stricter: a multi-line flow collection whose closing bracket is not indented deeper than its parent key is now a parse error. Parse errors are reported at the offending token instead of the end of the document.
Fixed an issue where the bundle command rewrote internal $refs pointing to other $refs.
The issue caused AsyncAPI 3 operation messages references to point to components instead of channel messages.
--ignore-headers option to the experimental drift and proxy commands.
It takes a comma-separated list of header names to skip in undocumented-header checks, and a trailing * matches by prefix (for example x-consumer-*).
Use it to silence headers a gateway or proxy adds that are not part of the API contract.generate-spec command that infers an OpenAPI description from recorded HTTP traffic.Fixed the drift command's schema-consistency rule reporting false-positive "Undocumented query parameter" findings for deepObject-style query parameters.
Traffic keys like namespace[id]=...&namespace[name]=... are now matched to the documented namespace parameter, and the reconstructed object is validated against the parameter schema.
Fixed an issue where the drift command's schema-consistency rule reported false-positive request findings for exchanges the server rejected with a 4xx client error.
For example: missing required parameter, missing required body, request-body schema mismatch.
A 4xx response means the server never accepted the request.
Validating it against the operation's success-path contract flagged the server's own correct rejection as drift.
Response-side validation still runs, so a documented error response whose shape differs from reality is still reported.
Fixed an issue where the join command silently dropped path-level x-* extensions with non-string values.
Updated js-yaml from 4.2.0 to 5.2.1.
Fixed an issue where strings that look like numbers with underscores (for example '12_34') had quotation marks removed by the bundle command.
These strings stay quoted in the output.
Note: YAML parsing is stricter: a multi-line flow collection whose closing bracket is not indented deeper than its parent key is now a parse error. Parse errors are reported at the offending token instead of the end of the document.
Fixed an issue where the drift command's security-baseline rule reported false-positive "credential exposure over insecure HTTP transport" warnings for traffic captured against loopback hosts, for example: localhost, *.localhost, 127.0.0.0/8, [::1].
Sandboxed recordings no longer produce transport warnings.
Fixed an issue where the bundle command rewrote internal $refs pointing to other $refs.
The issue caused AsyncAPI 3 operation messages references to point to components instead of channel messages.
Updated @redocly/openapi-core to v2.40.0.
Updated @redocly/openapi-core to v2.39.0.
struct rule to validate the contents of AsyncAPI protocol-specific bindings.
Added typed definitions for the sns, sqs, ibmmq, googlepubsub, pulsar and ros2 bindings.struct rule to validate the contents of AsyncAPI protocol-specific bindings.
Added typed definitions for the sns, sqs, ibmmq, googlepubsub, pulsar and ros2 bindings.Updated @redocly/openapi-core to v2.38.0.
drift command that compares recorded HTTP traffic (HAR, Kong, Nginx/Apache JSON, NDJSON) against an OpenAPI description and reports undocumented endpoints, schema mismatches, and security findings.proxy command that captures live HTTP traffic through a reverse proxy into a HAR file and optionally validates it against an OpenAPI description in real time.Updated @redocly/openapi-core to v2.37.0.
.graphql / .gql)..graphql / .gql).Updated @redocly/config to v0.49.1.
build-docs, ensuring the script's integrity.Updated @redocly/openapi-core to v2.35.1.
Updated @redocly/openapi-core to v2.35.0.
lint command.spec-step-mutually-exclusive-fields Arazzo rule to flag steps that use more than one mutually exclusive operation field (operationId, operationPath, workflowId, channelPath, or x-operation).Updated @redocly/openapi-core to v2.34.0.
Improved CLI install speed by bundling the CLI into a dependency-free package.
Warning: The published package no longer ships runtime dependencies in node_modules.
Plugins that relied on importing packages hoisted from the CLI (such as @redocly/openapi-core) must now declare those packages as their own dependencies.
Updated @redocly/openapi-core to v2.33.2.
split command that might have written files outside the chosen --outDir.Updated @redocly/openapi-core to v2.33.1.
4.1.1 to 4.2.0.Fixed a remote code execution vulnerability where a crafted $faker expression in an Arazzo description could execute arbitrary JavaScript during Redoc…
$faker expression in an Arazzo description could execute arbitrary JavaScript during Redocly Respect runs.
Reported by Hamza Haroon (GitHub: @thegr1ffyn).--component-names-strategy option to the bundle command.
This option allows a choice of how inline Schema components are named: basename (default) or title (from each schema's title field).--component-names-strategy option to the bundle command.
This option allows a choice of how inline Schema components are named: basename (default) or title (from each schema's title field).Fixed respect schema checks to honor readOnly and writeOnly based on context.
Fixed respect schema checks to honor readOnly and writeOnly based on context.
Warning: writeOnly properties in responses are reported as errors.
Updated @redocly/openapi-core to v2.32.2.
Updated @redocly/openapi-core to v2.32.1.
Added support for junit output in the lint command.
junit output in the lint command.junit output in the lint command.Updated @redocly/openapi-core to v2.31.6.
lint --format=checkstyle to produce a single combined XML document when multiple APIs are passed to the command, instead of concatenated per-file documents.Updated @redocly/openapi-core to v2.31.5.
Updated the no-unused-components rule to validate unused security schemes.
Fixed the remove-unused-components decorator to remove unused security schemes.
Warning: The bundler may now remove more unused components than before.
Updated the no-unused-components rule to validate unused security schemes.
Pinned the official Docker image base to node:24-alpine.
Fixed the remove-unused-components decorator to remove unused security schemes.
Warning: The bundler may now remove more unused components than before.
Updated @redocly/openapi-core to v2.31.5.
Fixed an issue where running respect on multiple Arazzo files in a single invocation could surface false-positive struct lint errors.
respect on multiple Arazzo files in a single invocation could surface false-positive struct lint errors.Updated @redocly/openapi-core to v2.31.3.
HTTP_PROXY, HTTPS_PROXY, and NO_PROXY environment variables when loading remote source descriptions or resolving external $refs.
Proxy settings are consistently applied during reference resolution as well.Updated @redocly/openapi-core to v2.31.2.
Fixed the remove-unused-components decorator to remove unused components containing allOf keyword.
Warning: The bundler may now remove more unused components than before.
Fixed the no-unused-components rule to highlight unused schemas containing allOf keyword.
Fixed the remove-unused-components decorator to remove unused components containing allOf keyword.
Warning: The bundler may now remove more unused components than before.
Fixed the no-unused-components rule to highlight unused schemas containing allOf keyword.
Updated @redocly/openapi-core to v2.31.2.
Updated @redocly/openapi-core to v2.31.1.
Updated @redocly/openapi-core to v2.31.0.
Updated @redocly/openapi-core to v2.30.6.
Fixed an issue where query-language strings (JSONPath, XPath, SPARQL, OPA) in Respect request bodies were incorrectly treated as runtime expressions.
redocly.yaml caused a config validation error during the build.--har-output option in the respect command.Updated @redocly/openapi-core to v2.30.4.
contains assertion to check that all listed strings are present in an array property.styled-components dependency to 6.4.1.Updated better-ajv-errors to v2.0.3.
better-ajv-errors to v2.0.3.@redocly/ajv to v8.18.1@redocly/ajv to v8.18.1Updated @redocly/openapi-core to v2.30.2.
Updated @redocly/openapi-core to v2.30.1.
push command to better support slower uploads.Updated @redocly/openapi-core to v2.30.0.
reference property to context.report() so that custom rules can link to external documentation.
When set, the URL is rendered beneath the message in both stylish and github-actions output formats.
Configurable rules also accept a top-level reference field.Updated @redocly/openapi-core to v2.29.2.
GHSA-xq3m-2v4x-88gg vulnerabilitiy by updating dependency versions.Made Respect's JSONPath criteria compliant with RFC 9535.
mapping values written as bare local file names were not resolved during build.mapping values written as bare local file names were not resolved during build.Updated @redocly/openapi-core to v2.29.0.
score command that analyzes OpenAPI 3.x descriptions and produces an AI Agent Readiness score (0-100).
Reports normalized subscores, raw per-operation metrics, and top hotspot operations with human-readable explanations. Supports --format=stylish (default) and --format=json output.push command.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.One column per quarter.