2.14.1

(fix): Fix 2.0.0-rc0 CLI migration to properly migrate coerce-enums-to-literals setting for AsyncAPI specs. Previously, the migration only handled this setting for OpenAPI specs.


2.14.0

(feat): Log the pull request URL when an SDK is generated with self-hosted GitHub pull-request mode.

2.13.1

(fix): Respect generators.yml auth-schemes override.


2.13.0

(feat): Allow all API settings to be overridden at the generator level in generators.yml.

(feat): Add CLI migration to automatically convert deprecated generator-level API settings keys to their new equivalents: use-title to title-as-schema-name, and unions: v1 to prefer-undiscriminated-unions-with-literals: true.

2.12.0

(feat): Support per-generator auth-schemes override in generators.yml. Generators can now define their own auth-schemes at the generator level, which takes precedence over top-level definitions.

1# generators.yml
2api:
3 auth: Bearer
4 auth-schemes:
5 Bearer:
6 scheme: bearer
7
8groups:
9 php-sdk:
10 generators:
11 - name: fernapi/fern-php-sdk
12 version: 1.23.0
13 api:
14 auth: Bearer
15 auth-schemes:
16 Bearer:
17 scheme: bearer
18 get-token: POST /authorize

2.10.0

(feat): Support per-generator specs override in generators.yml. Generators can now redefine the api.specs configuration at the individual generator level, allowing different specs configurations for different generators.

1# generators.yml
2api:
3 specs:
4 - openapi: openapi.yml
5
6groups:
7 php-sdk:
8 generators:
9 - name: fernapi/fern-php-sdk
10 version: 1.23.1
11 api:
12 specs:
13 - openapi: custom-openapi.yml

2.11.0

(feat): When converting OpenAPI to Fern Definition, if all endpoints in a service have auth: true, set the auth: true at the service level, and remove it from individual endpoints.

2.9.0

(fix): When importing OpenAPI specs, endpoints now properly inherit authentication requirements defined at the global level.


2.8.2

(fix): Fix dynamic snippet property ordering for types with inheritance. Types that are extended by other types now have their own properties ordered before inherited properties in the Dynamic IR. This fixes Java SDK staged builder compilation errors where method call order is enforced at compile time.

2.8.1

(fix): Support a lines prop for the <Code /> component to extract specific lines from a code snippet.

2.8.0

(feat): Adds an option for api.tag-description-pages: true to create summary pages from tag descriptions within an API reference.

2.7.1

(fix): Fix fern docs dev bug on Windows where asset paths were not parsing correctly

2.7.0

(feat): Support per-generator auth overrides in generators.yml. In the following example the TypeScript SDK generator will use Basic auth while the rest of the APIs use OAuth.

1# generators.yml
2auth-schemes:
3 OAuth:
4 scheme: oauth
5 type: client-credentials
6 get-token:
7 endpoint: POST /authorize
8 Basic:
9 scheme: basic
10
11api:
12 auth: OAuth
13 specs:
14 - openapi: openapi.yml
15
16groups:
17 ts-sdk:
18 generators:
19 - name: fernapi/fern-typescript-sdk
20 version: 3.33.0
21 api:
22 auth: Basic

2.6.2

(fix): Support generating examples for x-fern-type: literal<...> values in OpenAPI specs. Parameters with literal type annotations now generate examples using the underlying literal value.

2.6.1

(fix): Fix docs broken-links validator incorrectly flagging external URLs that contain the docs domain in query parameters.

2.5.2

(fix): Remove spammy “Cannot resolve source” warnings for OpenAPI sources in unioned API configurations with dependencies.


2.6.0

(feat): Support 4XX and 5XX patterns in OpenAPI specs for docs.

2.5.1

(fix): Add validation for instance URLs to ensure they are valid.

2.5.0

(feat): Support product and version-specific announcements in docs.yml.


2.2.6

(fix): Update local development refresh behavior when updating the sidebar-title override, or a slug override of a page. The preview should now navigate to the new slug instead of showing a 404.


2.2.5

(chore): Revert “fix(openapi): handle situations where discriminated unions reference unknown variants”

2.2.4

(fix): Re-publish CLI.

2.2.3

(fix): Support <Code /> components with props formatted on multiple lines.

2.4.0

(feat): Add branch support to self-hosted GitHub generation. Users can now specify a target branch in their generators.yml configuration using the branch field. When specified, generated code will be pushed to that branch instead of the default branch.

2.2.1

(fix): Add clarified output for unchanged generator versions (i.e., generators already on the latest version) to fern generator upgrade.

2.2.0

(feat): Support x-code-samples in OpenAPI specs on the latest version of the OpenAPI parser.


2.3.0

(fix): Add messaging about AI example generation to the CLI.

2.1.0

(feat): Add detailed output to fern generator upgrade showing which generators were upgraded, their version changes, and changelog links. The command now displays a summary grouped by workspace and group, or reports “All generators are already up to date” when no upgrades are applied.

2.0.4

(fix): Optimize docs generation and image path parsing and replacement for large markdown files (>5MB) using batched edits, precomputed line positions, and filtered AST traversal.

2.0.3

(fix): Updates CLI dependencies to fix fern commands.

2.0.2

(fix): Updates dependencies to fix fern commands.

2.0.1

(fix): Updates the beta write-translation command to use --stub flag for mocking translation configuration.

2.0.0

(feat): Support sidebar title overrides in the frontmatter of markdown files.

2.0.0-rc2

(fix): Improve misc error handling, including for illegal version strings.

2.0.0-rc1

(fix): Fix migration directory name to match exported version (2.0.0-rc0).

2.0.0-rc0

(break): Change default for OpenAPI parsing setting:

  • coerce-enums-to-literals: false (was true) The CLI will automatically upgrade your generators.yml to explicitly set the old default to preserve existing behavior. New users will get the new default.

1.11.3

(fix): Improve misc error handling, including for illegal version strings


1.11.2

(fix): Fix OpenAPI enum references being inlined instead of preserved as references. Enum schemas (type: string with enum property) are no longer treated as inlinable primitives, ensuring that $ref to enum schemas maintain their reference structure in the generated IR.

1.11.1

(fix): Fix AutoVersioning to exclude Fern branding from commit messages and PR titles/descriptions when whitelabel config is present.

1.11.0

(feat): Use commit message for auto versioning PR title and description. When auto versioning is successful, the first line of the commit message becomes the PR title and the rest becomes the PR body.

1.10.3

(fix): Fix whitelabel behavior for local generation.