NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
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 the push-status and push --wait-for-deployment commands did not show why a deployment to Redocly platform failed. The error messa
push-status and push --wait-for-deployment commands did not show why a deployment to Redocly platform failed.
The error message lists the failed checks, and the command output includes the link checker result.respect runtime expressions to accept every character that the Arazzo grammar allows, so put a space before && that follows a pointer, as in $response.body#/flag && $statusCode == 200.~0 and ~1 escapes in JSON Pointers of respect runtime expressions, so a pointer can reach a key that contains ~ or /.respect reported an unresolved workflow output instead of the failed step that caused it, and stopped the other workflows of the file.respect could run values from API responses and step outputs as code when it evaluated runtime expressions.respect runtime expressions to read a backslash in a string literal as written, so "a\nb" no longer contains a newline.Your coding agent can read these notes before it upgrades. Set up the MCP server →
push-status and push --wait-for-deployment commands did not show why a deployment to Redocly platform failed.
The error message lists the failed checks, and the command output includes the link checker result.respect runtime expressions to accept every character that the Arazzo grammar allows, so put a space before && that follows a pointer, as in $response.body#/flag && $statusCode == 200.~0 and ~1 escapes in JSON Pointers of respect runtime expressions, so a pointer can reach a key that contains ~ or /.respect reported an unresolved workflow output instead of the failed step that caused it, and stopped the other workflows of the file.respect could run values from API responses and step outputs as code when it evaluated runtime expressions.respect runtime expressions to read a backslash in a string literal as written, so "a\nb" no longer contains a newline.Fixed an issue where respect sent cnonce="undefined" in every HTTP Digest Authorization header instead of a random client nonce.
respect sent cnonce="undefined" in every HTTP Digest Authorization header instead of a random client nonce.respect failed HTTP Digest authentication when the server's WWW-Authenticate header had no opaque parameter.respect failed HTTP Digest authentication when a value in the server's WWW-Authenticate header contained = or ,, such as a base64 nonce with padding.@redocly/reunite-integration package to @redocly/platform-integration, and its Reunite* exports to Platform*: ReuniteApi, ReuniteApiClient, ReuniteApiError, InvalidReuniteUrlError, REUNITE_URLS, getReuniteUrl, and isValidReuniteUrl.respect sent cnonce="undefined" in every HTTP Digest Authorization header instead of a random client nonce.respect failed HTTP Digest authentication when the server's WWW-Authenticate header had no opaque parameter.respect failed HTTP Digest authentication when a value in the server's WWW-Authenticate header contained = or ,, such as a base64 nonce with padding.Updated @redocly/openapi-core to v2.75.0.
platform option and the access.rbac.platform scope in redocly.yaml.redocly.yaml, for example reunite, which platform replaces.platform option and the access.rbac.platform scope in redocly.yaml.redocly.yaml, for example reunite, which platform replaces.TypeError on a response with a oneOf or anyOf value without a discriminator.Updated @redocly/openapi-core to v2.74.0.
color option of formatProblems, which switched colors on or off for the whole process.
The output follows the terminal detection, so set FORCE_COLOR or NO_COLOR to override it.lint reported Media Type Objects under components.mediaTypes in OpenAPI 3.2 descriptions as invalid.
A $ref to such an object goes in a content entry, as the specification defines.lint reported the encoding, prefixEncoding, and itemEncoding fields of a nested Encoding Object in OpenAPI 3.2 descriptions as invalid.
The spec-no-invalid-encoding-combinations rule also checks nested Encoding Objects.json output so that they no longer carry terminal color codes.spec-strict-refs rule so that it no longer reports a $ref to a Media Type Object in a content entry of OpenAPI 3.2 descriptions.Updated @redocly/openapi-core to v2.73.0.
no-server-variables-empty-enum rule to the spec ruleset for OpenAPI 3.1 and 3.2 descriptions, where the specification requires a non-empty enum that holds the default value.Added usage telemetry and the onSettled hook to the generated Go, Python, and PHP clients.
Renamed a schema named UsageTelemetry, UsageTelemetryOptions, UsageTelemetryEvent, NewUsageTelemetry, or FlushUsageTelemetry in every generated client, for example to UsageTelemetry_2, so that it does not clash with the usage telemetry code.
If your code uses one of these generated types, update its name.
Added the --report option to the generate-client command.
It writes a JSON file with the operations of each API and the warnings of the run, each with a stable kind.
A custom or ejected generator gets reportFinding in its run input, to add its own warnings to the report.
Note: wrappableOperations from @redocly/client-generator/contracts/typescript takes reportFinding as its third argument.
A custom or ejected swr or tanstack-query generator must pass the reportFinding that its run receives.
Added the no-server-variables-empty-enum rule to the spec ruleset for OpenAPI 3.1 and 3.2 descriptions, where the specification requires a non-empty enum that holds the default value.
Fixed an issue where the generated PHP client threw TimeoutError for a refused connection instead of a transport error.
Fixed an issue where the TypeScript usage telemetry counted 0 attempts for a call aborted before its first attempt, so an event had fewer attempts than calls.
Fixed an issue where the generated PHP client retried a POST or PATCH without an Idempotency-Key, and retried a 501 or a 505 to 599.
The default retry follows the same rule as the other generated clients.
Note: To retry a POST or PATCH, pass an idempotencyKey to the call, or pass a retryOn callable in Config->retry.
Updated @redocly/client-generator to v0.9.0.
Updated @redocly/openapi-core to v2.73.0.
Updated @redocly/openapi-core to v2.72.1.
@redocly/openapi-core for the browser failed with "fileURLToPath" is not exported and "pathToFileURL" is not exported errors.Updated @redocly/config to v0.69.0.
respect ignored the dataValue field of OpenAPI 3.2 examples when a step took its parameters or request body from the API description.respect ignored parameters defined on a path item when a step used operationId and took its request data from the API description.diff command that compares two API descriptions, reports changes, and rates every change by the semver bump it requires (patch, minor, or major).
--fail-on sets the impact that fails the run and --check-version verifies that info.version was bumped accordingly.skills command, shown the first time you run Redocly CLI.
To turn off announcements, set the REDOCLY_SUPPRESS_NOTIFICATIONS environment variable to true.java generator to the generate-client command.diff command that compares two API descriptions, reports changes, and rates every change by the semver bump it requires (patch, minor, or major).
--fail-on sets the impact that fails the run and --check-version verifies that info.version was bumped accordingly.respect ignored the dataValue field of OpenAPI 3.2 examples when a step took its parameters or request body from the API description.respect ignored parameters defined on a path item when a step used operationId and took its request data from the API description.generate-spec, generate-arazzo, and recheck commands to print their execution time in milliseconds, the same as the lint and bundle commands.Updated @redocly/openapi-core to v2.71.2.
no-unresolved-refs rule reported discriminator mapping values that are schema names (for example, dog: Dog) as unresolved references.
The rule still reports schema names that do not match a schema in components.schemas.bundle command didn't resolve a $ref in an overlay that pointed to a local file when the API description was a URL.
The command tried to download the file from the server that hosts the API description instead of reading it from disk.no-unresolved-refs rule reported discriminator mapping values that are schema names (for example, dog: Dog) as unresolved references.
The rule still reports schema names that do not match a schema in components.schemas.drift and generate-spec commands crashed with a stack trace when the traffic file or folder didn't exist, and the generate-spec command when the traffic had no matching HTTP exchanges.bundle command didn't resolve a $ref in an overlay that pointed to a local file when the API description was a URL.
The command tried to download the file from the server that hosts the API description instead of reading it from disk.408, 429, or 5xx status.
The client adds these counts to the next send.Updated @redocly/openapi-core to v2.71.1.
writeOnly properties in response types, mock data that broke the API description, and generated code that failed strict type checks.Added the early access project pr create and project pr status commands to open a pull request in Redocly platform for the current branch of a cloned
project pr create and project pr status commands to open a pull request in Redocly platform for the current branch of a cloned project and to show its status.project pr create and project pr status commands to open a pull request in Redocly platform for the current branch of a cloned project and to show its status.Updated @redocly/openapi-core to v2.70.0.
build-docs command to Redoc 3 and added support for AsyncAPI descriptions and GraphQL schemas.
Added the --openapi, --asyncapi, --graphql, and --inlineBundle options.
Removed --theme.openapi and --disableGoogleFont, pass Redoc options with --openapi instead.
Some Redoc 2 options were renamed or removed, see the build-docs documentation.
The command now applies the decorators and preprocessors from the configuration file.
Pages built with the build-docs command now send Redoc telemetry from readers' browsers by default.Updated @redocly/openapi-core to v2.69.0.
preview command now runs @redocly/framework and accepts the pro, scale and enterprise plans with the --plan option.
A project whose package.json lists @redocly/realm, @redocly/redoc, @redocly/revel, @redocly/reef or one of their blends still previews with that package.
The --product option is deprecated.Updated @redocly/openapi-core to v2.68.0.
parameters field of Arazzo 1.1.0 success and failure actions to the respect command.
When an action references a workflow with workflowId, respect passes the action's parameters to that workflow as inputs.Fixed an issue where respect didn't retry a step when its retry failure action had no retryLimit.
Note: Previously, a workflow continued with the next step after a step had failed and used up its retries.
Fixed an issue where respect skipped a retry failure action after an earlier retry action of the same step had used up its retries.
Updated @redocly/openapi-core to v2.68.0.
struct rule didn't report Arazzo 1.1.0 success and failure actions that had parameters without a workflowId, or action parameters with an in field.
Action parameters are passed as inputs to the target workflow, so they require a workflowId and can't have an in field.
Existing Arazzo descriptions with these actions fail lint, and respect doesn't run them.parameters field of Arazzo 1.1.0 success and failure actions to the respect command.
When an action references a workflow with workflowId, respect passes the action's parameters to that workflow as inputs.Fixed an issue where the struct rule didn't report Arazzo 1.1.0 success and failure actions that had parameters without a workflowId, or action parameters with an in field.
Action parameters are passed as inputs to the target workflow, so they require a workflowId and can't have an in field.
Existing Arazzo descriptions with these actions fail lint, and respect doesn't run them.
Fixed an issue where respect didn't retry a step when its retry failure action had no retryLimit.
Note: Previously, a workflow continued with the next step after a step had failed and used up its retries.
Fixed an issue where respect skipped a retry failure action after an earlier retry action of the same step had used up its retries.
Updated @redocly/openapi-core to v2.68.0.
Updated @redocly/respect-core to v2.68.0.
Updated @redocly/openapi-core to v2.67.1.
respect command kept the inputs that a step passed to a workflow in the same file.
Later runs of that workflow used them instead of their --input values or schema defaults.Updated @redocly/openapi-core to v2.67.0.
excludedMethods option to the operation-4xx-response rule, which skips operations that use the listed HTTP methods.excludedMethods option to the operation-4xx-response rule, which skips operations that use the listed HTTP methods.Updated @redocly/openapi-core to v2.66.1.
oneOf.Updated @redocly/config to v0.67.0.
skills command that installs the Redocly CLI agent skills for AI coding agents.Updated @redocly/openapi-core to v2.65.1.
Fixed the no-schema-type-mismatch rule to report properties on any non-object type and items on any non-array type, such as type: string with properties.
Previously, the rule only reported properties on array and items on object.
Note: Because the rule is an error in the recommended ruleset, descriptions that passed before may now fail.
Fixed an issue where the struct rule incorrectly reported an error for type: file in response schemas of OpenAPI 2.0 API descriptions.
Updated @redocly/openapi-core to v2.65.0.
capitalization assertion in recheck rules so that it names the style, such as "sentence case", instead of printing $sentence.lintFiles and runRulesUntilStable so that, with fix, they return the problems that remain in the fixed content.
Note: Before, they returned the problems found before fixing; to get those, lint without fix first.--openapi-version option to the generate-spec command to choose between OpenAPI 3.1 and 3.2 (the default) for the generated description.capitalization assertion in recheck rules so that it names the style, such as "sentence case", instead of printing $sentence.redocly recheck --fix so that the report lists only the findings that remain after the fixes, not the findings it just fixed.redocly recheck --fix summary so that inserted text with a line break prints as \n instead of breaking the output line.Updated @redocly/openapi-core to v2.64.1.
respect command altered string values in runtime expressions that contained a dot followed by a digit.
For example, a token read through $response.body#/token or a quoted value in success criteria.lint and bundle crashed with Unknown type name found: string on OpenAPI 3.2 descriptions that had a deviceAuthorization OAuth flow with non-empty scopes.respect command altered string values in runtime expressions that contained a dot followed by a digit.
For example, a token read through $response.body#/token or a quoted value in success criteria.lint and bundle crashed with Unknown type name found: string on OpenAPI 3.2 descriptions that had a deviceAuthorization OAuth flow with non-empty scopes.Updated @redocly/config to v0.66.0.
@redocly/config to v0.66.0.onSettled middleware hook to the generated TypeScript client.
Added the client.telemetry option to the generate-client command.@redocly/config to v0.66.0.onSettled middleware hook to the generated TypeScript client.
Added the client.telemetry option to the generate-client command.Updated @redocly/openapi-core to v2.63.0.
Added the body-link pagination style to the generate-client command.
Generated clients use it to follow the next page URL from a field in the response, set with the nextLink option.
The tanstack-query generator also creates infinite query options for these operations.
AbortSignal.timeout() or AbortSignal.any(). Timed-out requests correctly throw TimeoutError instead of AbortError in Chrome 103–123.Fixed an issue where the login and push did not exit after a request through a proxy timed out.
login and push did not exit after a request through a proxy timed out.login, push, and other Reunite commands failed on Node.js 26.
Updated undici to the 7.30.0 version.login and push did not exit after a request through a proxy timed out.login, push, and other Reunite commands failed on Node.js 26.
Updated undici to the 7.30.0 version.handlebars to 4.7.10 to resolve CVE-2026-106444, CVE-2026-106445, and CVE-2026-106446.respect command ignored the --mtls certificates when a request went through a proxy.Updated @redocly/openapi-core to v2.62.1.
project clone command so that Git keeps finding its credential helper after a clone run with npx or pnpm dlx.Updated @redocly/openapi-core to v2.62.0.
project clone command to work with a Redocly-hosted Reunite project as a Git repository.in: querystring parameters to the experimental drift command.
The command validates the whole query string against the parameter's schema, instead of reporting every query key as undocumented.
In --coverage, each key of a form-urlencoded querystring schema counts as a separate parameter.project clone command to work with a Redocly-hosted Reunite project as a Git repository.schema-consistency rule of the drift command so that a required readOnly property in a parameter schema is no longer reported as missing from the request.Updated @redocly/openapi-core to v2.61.0.
@redocly/config to v0.65.0.Content-Type wins over the one in the API description.@modelcontextprotocol/sdk to 1.32.1 to resolve GHSA-6qxp-vccf-f47h.Updated @redocly/openapi-core to v2.60.0.
--file-name-conflicts-severity option for the split command to control how file name conflicts are reported.Fixed an issue where split lost content when two components, paths, webhooks, channels, operations, or code samples got the same file name.
Warning: split output may differ from older releases: when several names would share one file, each later file now gets a -n suffix, where n is its order, for example user-2.yaml next to User.yaml.
Updated @redocly/config to v0.62.0.
@redocly/config to v0.62.0.Improved redocly recheck to lint the description fields of API descriptions.
Findings report the source line and column.
You can suppress the findings by file, rule, and pointer, or adjust rules for descriptions only.
Note: ResolvedRecheckConfig gains a required descriptionRules field.
Library code that builds that object by hand must set it.
Improved redocly recheck to lint the description fields of API descriptions.
Findings report the source line and column.
You can suppress the findings by file, rule, and pointer, or adjust rules for descriptions only.
Note: ResolvedRecheckConfig gains a required descriptionRules field.
Library code that builds that object by hand must set it.
brace-expansion to 2.1.7 and 5.0.12, dompurify to 3.4.16, fast-uri to 3.1.8, and js-yaml to 5.4.3 to resolve CVE-2026-102276, CVE-2026-102277, CVE-2026-102278, CVE-2026-86472, GHSA-p98j-92pf-mc4p, and GHSA-r3ph-w7gj-g6xm.oxfmt to 0.72.0 and tinypool to 2.2.0 to resolve CVE-2026-104848 and CVE-2026-104849.proxy-addr to 2.0.8 and source-map-js to 1.2.2 to resolve CVE-2026-90711 and CVE-2026-93749.Updated @redocly/openapi-core to v2.58.2.
Undefined constant "OPERATIONS" when OPcache preload was enabled.Improved performance of the no-invalid-media-type-examples, no-invalid-schema-examples, and no-invalid-parameter-examples rules by reusing validators
no-invalid-media-type-examples, no-invalid-schema-examples, and no-invalid-parameter-examples rules by reusing validators for schemas that are referenced or repeated.@redocly/config to v0.61.1.no-invalid-media-type-examples, no-invalid-schema-examples, and no-invalid-parameter-examples rules by reusing validators for schemas that are referenced or repeated.@redocly/config to v0.61.1.Added the redocly recheck command. It lints Markdown prose and structure from the recheck block in redocly.yaml, with presets named in the root extend
Added the redocly recheck command.
It lints Markdown prose and structure from the recheck block in redocly.yaml, with presets named in the root extends (for example recheck/markdown).
Presets merge with the recheck blocks in extends order, like other presets.
The engine's actions return data.
The CLI prints it.
Two agent skills ship in the package under skills/ and with the repository's other skills: recheck-lint runs the command on touched Markdown, and recheck-config tunes the recheck block.
Added the @redocly/recheck engine package to this repository.
It powers the upcoming redocly recheck command.
@redocly/recheck/presets exports the presets as a plugin for @redocly/openapi-core.
Note: the standalone recheck binary and recheck.yaml are removed.
Configuration moves to the recheck block of redocly.yaml, read by the redocly recheck command in a later release.
From version 2.x this package lives in the redocly-cli repository and releases with Redocly CLI.
Entries below 2.x come from its previous home.
Updated @redocly/openapi-core to v2.57.0.
Added const checking to the no-enum-type-mismatch rule: a const value must conform to the schema's type, the same way every enum value does.
Note: linting output may include new errors for schemas whose const value doesn't match their type.
no-enum-type-mismatch dropped violations and reported a wrong location when type was written as an array.Updated @redocly/openapi-core to v2.56.1.
Updated undici to the 6.29.0 version.
undici to the 6.29.0 version.respect failed with an unexpected error when a step used an operationId without the $sourceDescriptions.<name>. prefix and the Arazzo file also listed an arazzo source description.
Such operationIds are looked up in the openapi source descriptions only.bundle command output.
Pass overlays with the new --overlay option or list them under overlays for an API in redocly.yaml.copy action field, the $self field, and reusable actions in components.actions.
The spec-ref-siblings rule now checks the fields next to a reusable action $ref in Overlay documents.bundle command output.
Pass overlays with the new --overlay option or list them under overlays for an API in redocly.yaml.copy action field, the $self field, and reusable actions in components.actions.
The spec-ref-siblings rule now checks the fields next to a reusable action $ref in Overlay documents.respect failed with an unexpected error when a step used an operationId without the $sourceDescriptions.<name>. prefix and the Arazzo file also listed an arazzo source description.
Such operationIds are looked up in the openapi source descriptions only.undici to the 6.29.0 version.Added the --replace option to the push command. --replace removes the files under the mount path that are not part of the push.
--replace option to the push command.
--replace removes the files under the mount path that are not part of the push.respect so known secrets are masked in non-JSON request bodies, such as application/x-www-form-urlencoded token requests.respect so a step fails with a clear error when a runtime expression embedded in a string has no value, such as Bearer {$outputs.accessToken}.workflow-dependsOn rule reported a duplicate when different workflows listed the same workflow in dependsOn.--replace option to the push command.
--replace removes the files under the mount path that are not part of the push.respect so known secrets are masked in non-JSON request bodies, such as application/x-www-form-urlencoded token requests.respect so a step fails with a clear error when a runtime expression embedded in a string has no value, such as Bearer {$outputs.accessToken}.workflow-dependsOn rule reported a duplicate when different workflows listed the same workflow in dependsOn.Added the value of the REDOCLY_ENVIRONMENT environment variable to the user-agent header of the login, push, and push-status requests.
REDOCLY_ENVIRONMENT environment variable to the user-agent header of the login, push, and push-status requests.application/gzip, application/x-tar), PDF files, Office documents, audio, video and font responses as JSON instead of decoding them as binary.REDOCLY_ENVIRONMENT environment variable to the user-agent header of the login, push, and push-status requests.Updated @redocly/config to v0.57.0.
Nothing published for this version
Nothing published for this version
Fixed respect so a same-workflow goto no longer cleared $steps outputs from steps that already ran. Previously, this broke $steps expressions in the t
respect so a same-workflow goto no longer cleared $steps outputs from steps that already ran.
Previously, this broke $steps expressions in the target step.Added start and end line and column positions to each problem location in the --format=json lint output.
start and end line and column positions to each problem location in the --format=json lint output.Added a deprecation warning to the build-docs command about the upcoming switch to Redoc 3.
build-docs command about the upcoming switch to Redoc 3.Updated @redocly/openapi-core to v2.53.0.
disallowDefault option to the operation-2xx-response rule, which requires an explicit 2xx response when enabled.
There is no change in current behavior.disallowDefault option to the operation-2xx-response rule, which requires an explicit 2xx response when enabled.
There is no change in current behavior.Updated @redocly/openapi-core to v2.52.1.
redoc to the 2.5.4 version to fix accessibility problems in the HTML produced by build-docs.
Added the lang attribute to the default build-docs template.Updated @redocly/openapi-core to v2.52.0.
strategy option to the component-name-unique rule, matching the --component-names-strategy option of the bundle command.redocly-cli for everyday CLI usage, redocly-lint-rules for writing configurable rules and custom plugins.
Install them with npx skills add https://redocly.com.inspect-node-types command to navigate the Redocly's node type tree of an API description.
inspect-node-types helps pick the correct subject types for a configurable rule or the correct visitor for a custom plugin.strategy option to the component-name-unique rule, matching the --component-names-strategy option of the bundle command.introspect-mcp command that analyzes a running MCP server and records its tools, prompts, resources, and capabilities.
introspect-mcp records its findings in the x-mcp extension of an OpenAPI description.Updated @redocly/openapi-core to v2.51.2.
fast-uri to the 3.1.7 version to resolve CVE-2026-75931, CVE-2026-75975, CVE-2026-75899, and CVE-2026-76172.drift and coverage failing to match a path template whose segment mixes literal text with parameters, such as /instances/{worldId}:{instanceId}.Fixed an issue where generate-arazzo produced a malformed remote description URL in sourceDescriptions (https:// collapsed to https:/) when --output-f
generate-arazzo produced a malformed remote description URL in sourceDescriptions (https:// collapsed to https:/) when --output-file was provided.$faker.string.email() used without options generated addresses at the undefined.com domain.@faker-js/faker to the 10.6.0 version to resolve the high severity advisory GHSA-qxc2-j82w-r537.Fixed an issue where respect and the x-security-scheme-required-values rule incorrectly rejected x-security HTTP schemes written with non-lowercase ca
respect and the x-security-scheme-required-values rule incorrectly rejected x-security HTTP schemes written with non-lowercase casing (such as Basic, Bearer, or Digest).
RFC 7235 scheme names are case-insensitive.generate-arazzo command to print a ready-to-run respect command after generation, including an --input placeholder for every workflow input.--with-ai, --ai-provider, --ai-model, --ai-concurrency, and --max-workflows options to the generate-arazzo command.
--with-ai uses a local AI CLI (claude, codex, or cursor) and OpenAPI descriptions to redesign the generated one-workflow-per-operation skeleton into multi-step workflows.
The AI designs at most --max-workflows workflows (default 10), and the generated file is marked as AI-inferred.
For descriptions that don't fit a single prompt, the AI first selects scenarios from a compact operation index, then it designs each workflow separately.respect and the x-security-scheme-required-values rule incorrectly rejected x-security HTTP schemes written with non-lowercase casing (such as Basic, Bearer, or Digest).
RFC 7235 scheme names are case-insensitive.Added a new schema assertion for configurable rules. The assertion validates a property value against a JSON Schema.
schema assertion for configurable rules.
The assertion validates a property value against a JSON Schema.schema assertion for configurable rules.
The assertion validates a property value against a JSON Schema.Updated @redocly/openapi-core to v2.49.1.
$refs pointed to the same path item.$refs pointed to the same path item.Added the no-illogical-composition-keywords rule.
Added the no-illogical-composition-keywords rule.
Note: the rule is set to warn in the recommended ruleset and to error in recommended-strict. Existing API descriptions may report new problems.
npm was not available.Updated @redocly/openapi-core to v2.48.0.
bundle command didn't resolve $refs inside an AsyncAPI 3 Multi Format Schema Object.python, go, php, and cli generators beside the TypeScript client, each self-documenting with --docs, configurable per generator, and available as source in your own repository through eject-generator.bundle command didn't resolve $refs inside an AsyncAPI 3 Multi Format Schema Object.respect --har-output recorded an empty postData for every request.
Request bodies are written to the HAR.
Captures replayed through drift can have their request bodies validated instead of silently passing.Updated @redocly/openapi-core to v2.47.0.
stats command that reports how many distinct x- extensions a description file uses and how often each one occurs.stats command reporting wrong parameter count for AsyncAPI descriptions.stats command that reports how many distinct x- extensions a description file uses and how often each one occurs.stats command reporting wrong parameter count for AsyncAPI descriptions.Updated @redocly/openapi-core to v2.46.2.
Improved the error message raised when a configurable rule is missing the assertions block.
Fixed an issue where the no-duplicated-enum-values rule didn't report duplicated enum values that are objects or arrays.
Fixed an issue where the no-duplicated-enum-values rule printed [object Object] when reporting duplicate values.
Updated @redocly/ajv to ^8.18.3.
@redocly/ajv to ^8.18.3.Updated @redocly/openapi-core to v2.46.0.
spec-ref-siblings rule that reports properties placed next to a $ref which the specification does not allow.spec-ref-siblings rule that reports properties placed next to a $ref which the specification does not allow.Updated @redocly/openapi-core to v2.45.0.
bundle command losing schema keywords (such as title, properties, or required) written next to a $ref when the referenced schemas started with their own $ref.bundle command losing schema keywords (such as title, properties, or required) written next to a $ref when the referenced schemas started with their own $ref.Updated @redocly/openapi-core to v2.44.2.
security-defined rule for AsyncAPI 2.x and 3.x in the recommended ruleset from error to warn.
AsyncAPI descriptions with undefined or unresolved security no longer fail linting by default.security-defined rule for AsyncAPI 2.x and 3.x in the recommended ruleset from error to warn.
AsyncAPI descriptions with undefined or unresolved security no longer fail linting by default.Updated @redocly/openapi-core to v2.44.1.
operation-4xx-problem-details-rfc7807 rule incorrectly reported the type and title properties inherited through allOf as missing.undici to the 6.28.0 version.operation-4xx-problem-details-rfc7807 rule incorrectly reported the type and title properties inherited through allOf as missing.Updated @redocly/openapi-core to v2.44.0.
Added the no-duplicated-enum-values rule that requires all values in an enum to be unique.
The rule is enabled at the warn level in the recommended ruleset.
Note: linting output may include new warnings for API descriptions that contain duplicated enum values.
Added the no-unsafe-markdown rule that disallows potentially executable content in description fields.
The rule is enabled at the warn level in the recommended ruleset.
Note: linting output may include new warnings for description fields that contain potentially executable content.
Added security-defined rule for AsyncAPI 2.x and 3.x.
Warning: this rule is enabled at error severity in the recommended ruleset, so AsyncAPI documents that previously linted clean may now fail. The rule flags security $refs that target an undefined scheme or a path outside components.securitySchemes, and operations that declare no security of their own when the applicable servers don't supply one either.
Added the no-duplicated-enum-values rule that requires all values in an enum to be unique.
The rule is enabled at the warn level in the recommended ruleset.
Note: linting output may include new warnings for API descriptions that contain duplicated enum values.
Added the no-unsafe-markdown rule that disallows potentially executable content in description fields.
The rule is enabled at the warn level in the recommended ruleset.
Note: linting output may include new warnings for description fields that contain potentially executable content.
One column per quarter.