3.19.0
(feat): Add explode field to PathParameter and QueryParameter types in the IR for OpenAPI parameter serialization control.
3.18.4
(fix): Revert regex parsing of <Code> components.
3.18.3
(fix): Fix duplicate type declarations when OpenAPI specs use allOf references in inline request bodies.
3.18.2
(fix): Remove fern check validation rule that rejected HEAD endpoints with response bodies. HEAD endpoints can now define response bodies without triggering validation errors.
3.18.1
(fix): Fix fern check errors when OpenAPI specs use allOf with multiple schemas that share the same property names in inline request bodies. The OpenAPI importer now correctly inlines conflicting schemas instead of extending them, preventing duplicate property errors.
3.18.0
(feat): Add ai-example-style-instructions field to docs.yml experimental config. This allows providing custom styling instructions for AI-generated examples to guide the AI in generating examples that match your preferred style, naming conventions, or domain-specific terminology.
3.17.0
(feat): Enable AI-generated endpoint examples by default. To disable, set ai-examples to false in docs.yml’s experimental settings.
3.16.1
(feat): Include examples for AI processing if 30% or more of the values are generic.
3.16.0
(feat): Docs linting (fern check) now respects settings.substitute-env-vars and throws errors for missing environment variables, matching the behavior of fern generate --docs. The full instances: config including custom domains now goes through env var substitution when this setting is enabled.
(fix): Improved error logging for docs publishing failures. When API definition registration fails with a “fetch failed” error, the CLI now logs detailed error information including status code, error type, reason, and error message to help debug network issues.
3.15.0
(feat): Add fern overrides compare command to generate OpenAPI overrides by diffing two specs. This enables a new workflow where you can copy your OpenAPI spec, edit the copy directly, and compile the differences into an overrides file.
3.15.1
(chore): Use Venus JWT for AI example enhancement requests.
3.14.0
(fix): Fix coerce-enums-to-literals: false setting not being respected for SDK generation. Single-value enums are now correctly preserved as enum types instead of being coerced to literals.
3.13.0
(feat): Add support for autorelease flag in generators.yml.
See: https://buildwithfern.com/learn/sdks/overview/autorelease#disable-autorelease
3.12.0
(feat): Add inferred auth parameters to the dynamic IR so dynamic snippet generators can consume them.
3.11.0
(feat): Fully propagate webhook responses (e.g., 204, 400, 500 status codes) from OpenAPI specs from IR to FDR.
3.10.0
(feat): Adds new right-text field to logo configuration in docs.yml. This allows users to display custom text to the right of the logo image.
3.9.0
(feat): Propagate webhook responses (e.g., 204, 400, 500 status codes) from OpenAPI specs to the IR. Webhook endpoints can now define expected response status codes and descriptions, which are captured in the IR for use by generators and documentation.
3.8.0-rc0
(chore): Test automated CLI publishing.
3.8.0
(feat): Include -y flag for the upgrade for non-interactive environments.
3.7.0
(feat): Add API flag default-integer-format to configure which format is assumed for type: "integer"
properties in OpenAPI that do not specify a format.
Possible values are int32, int64, uint32, and uint64; defaults to int32.
3.6.0
(feat): Validate examples in fern check against OpenAPI schemas.
3.5.0
(feat): Add support for vendor-specific JSON content types in example validation. Content types like application/vnd.bc.v1+json are now accepted as valid JSON content types when validating examples against literal<"application/json"> types.
3.4.5
(fix): Fix parsing of <Code> components with for attribute for synced tabs. The for attribute is now properly preserved when converting <Code> components to markdown code blocks, allowing synced tabs to work correctly across multiple <CodeGroup> sections.
3.4.4
(fix): Fallback to variant type for display name if title and mapping are not present.
3.4.3
(fix): Disallow absolute URLs as redirects in frontmatter slug definitions. links should be used in the navigation instead.
3.4.2
(fix): Fix fern generate crash when inheriting from a schema with top-level nullable: true via allOf. The OpenAPI importer now correctly strips nullable wrappers from type references in extends lists.
3.4.1
(fix): Map error response headers from IR to FDR for docs display.
3.4.0
(chore): Upgrade @fern-api/fdr-sdk to version 0.142.1-b1f6b6363 which adds support for error response headers.
3.3.0
(feat): Extend substitute-env-vars to apply to API specs (OpenAPI and Fern definitions) when generating docs. Environment variables using ${VAR_NAME} syntax in API spec descriptions, examples, and other string fields are now substituted when substitute-env-vars: true is set in docs.yml.
3.2.0
(feat): Add recursive markdown snippet resolution for docs. Markdown snippets can now reference other markdown snippets, with automatic detection and warning for circular references to prevent infinite loops.
3.1.0
(feat): Preserve error response headers (e.g., Retry-After for 429 errors) from OpenAPI specs in the IR.
3.0.5
(fix): Fix AsyncAPI validation: exclude AsyncAPI files from OpenAPI-specific validation rules
3.0.4
(fix): Fix error response examples not displaying in docs when examples are defined at the property level in OpenAPI specs.
3.0.3
(fix): Add basic preprocessing of names in the IR parser; for starters, [] -> Array.
3.0.2
(fix): Fix OpenAPI parsing to properly handle allOf with $ref references inside oneOf/anyOf schemas. Previously, inline objects with allOf references but no direct properties were incorrectly converted to map<string, any>. Now they are properly preserved as named types with inheritance.
