3.49.3
(fix): Fix per-generator API overrides incorrectly falling back to workspace name for namespace. The namespace field in per-generator specs configuration now correctly uses the provided value (or undefined if not set) instead of falling back to the workspace folder name.
3.49.2
(feat): Add support for omit field in basic auth configuration. This allows omitting the username or password from the SDK when defining basic authentication, useful for APIs that only require one of the two credentials.
3.48.3
(fix): Upgrade FDR and fix webhook example names not appearing in API reference docs. The name field is now included in webhook example FDR conversion, enabling the frontend to display user-specified example names instead of generic “Example 1”, “Example 2” labels.
3.48.2
(fix): Fix OpenAPI example summary not appearing as tab titles in API reference docs. The displayName (derived from OpenAPI summary field) is now always preserved in FDR output, even when there’s only one example per status code. Previously, example names were only shown when multiple examples had the same status code.
3.48.1
(fix): Fix x-fern-basic, x-fern-bearer, and x-fern-header OpenAPI extensions not being read in the OpenAPI to IR converter. Custom field names and environment variables specified in these extensions are now correctly propagated to the IR and FDR output, enabling custom labels in the API explorer.
3.48.0
(feat): Add support for extracting examples from multipart/form-data webhook payloads. Webhooks using multipart content type now properly display example names from the OpenAPI summary field instead of generic “Example 1”, “Example 2” labels. Also fixes webhook and WebSocket example names in FDR conversion to properly use the name field.
3.47.9
(fix): Fix Go package name normalization in dynamic IR generation. The CLI now normalizes Go package names by stripping the https:// prefix to match how upload keys are generated.
3.47.8
(fix): Support auth schemes Bearer and Basic with a capital B.
3.47.7
(fix): Fix duplicate summary collision in OpenAPI examples. When multiple examples have the same summary, the second example is now disambiguated as ${summary} (${key}) instead of silently overwriting the first.
3.47.6
(fix): Fix OpenAPI example summary field propagation. The summary field from OpenAPI examples is now correctly propagated to the IR displayName field and FDR name field. Previously, when examples were referenced via $ref, the summary field was lost because the reference was not resolved before checking for the summary. Also adds support for recursive $ref resolution in examples.
3.47.5
(fix): Fix AsyncAPI query parameters with $ref types being incorrectly marked as required.
3.47.4
(fix): Fix AI examples headers/path/query params not appearing in docs immediately after generation.
3.47.3
(fix): Improve error messages for authentication errors when publishing docs.
3.47.2
(fix): Skip loading AI examples during SDK generation. AI examples are now only loaded for docs generation (fern generate --docs), not for SDK generation (fern generate).
3.47.1
(fix): Fix AI example generation to filter path/query/header parameters from request bodies and omit empty request/response bodies. The AI model sometimes incorrectly includes these parameters in the request body, which causes SDK validation errors.
3.47.0
(feat): Add edit this page launch target
3.46.0
(feat): Propagate webhook multipart form data payloads to FDR conversion. The fileUploadPayload field on webhooks is now converted to the FDR FormDataRequest type, enabling proper rendering of file upload fields and body properties in documentation.
3.45.0
(feat): Add support for webhook multipart form data payloads. Webhooks with multipart/form-data content type are now properly parsed and include a fileUploadPayload field in the IR containing file and body property information.
3.44.1
(fix): Add air-gapped environment detection for AI example enhancement. The CLI now detects network availability before attempting AI enhancement by checking connectivity to Venus. In air-gapped environments, AI enhancement is automatically skipped to prevent network errors. This follows the same pattern used for protobuf generation air-gap detection.
3.44.0
(feat): Map OpenAPI validation fields from IR to FDR format. This includes exclusiveMinimum, exclusiveMaximum, and multipleOf for numeric types (integer, double, long, uint, uint64), as well as minItems/maxItems for list and set types, and minProperties/maxProperties for map types.
3.43.0
(feat): Add —indent flag to ‘fern api update’ to allow specification of indent size in spaces.
(feat): Add —indent flag to ‘fern export’ to allow specification of indent size in spaces.
3.42.4
(feat): Update experimental flag options to support exclude-apis
3.42.3
(fix): Downgrade OpenAPI reference validation to warning severity. Previously, invalid references were treated as errors.
3.42.2
(fix): Fix webhook audience filtering in OpenAPI v3 importer. Webhooks with x-fern-audiences are now correctly included when generating for matching audiences.
3.42.1
(fix): Rename java-model generator to fern-java-model.
3.42.0
(feat): Add placeholder page for python-docs in fern docs dev. When running local development, a helpful placeholder page is shown explaining that Python library documentation requires fern generate --docs or fern generate --docs --preview to generate.
3.41.1
(chore): Support ai-examples and ai-example-style-instructions configuration options from experimental with the new enabled and style, under ai-examples in the top-level docs.yml configuration.
3.41.0
(feat): Add support for x-fern-property-name extension on OpenAPI discriminators. This allows specifying a code-generation-friendly name for discriminant properties that have non-alphanumeric wire values (e.g., @type). The extension can be applied directly in the OpenAPI spec or via an overrides file.
3.40.1
(fix): Speed up AI example generation and reduce number of retries on failure.
3.39.4
(fix): Optimize air-gapped environment detection for protobuf generation. The CLI now detects network availability once at startup using a 30-second timeout instead of having multiple timeouts for each buf command. Both ProtobufIRGenerator and ProtobufOpenAPIGenerator now use a shared detectAirGappedMode() utility function that sets an isAirGapped flag to skip network calls after initial detection. This significantly improves performance in air-gapped environments.
3.40.0
(feat): Add support for OpenAPI min/max validation keywords in the IR. This includes minimum, maximum, exclusiveMinimum, exclusiveMaximum, and multipleOf for numeric types (float, long, uint, uint64), as well as minItems/maxItems for list and set containers, and minProperties/maxProperties for map containers and objects.
3.39.3
(fix): Fix protobuf air-gapped support to properly catch execa exceptions when buf dep update fails. The execa library throws exceptions on non-zero exit codes rather than returning a result object, so the network error detection logic was never being reached. Both ProtobufOpenAPIGenerator and ProtobufIRGenerator now wrap buf dep update in a try-catch block to properly handle network errors in air-gapped environments.
3.39.2
(chore): Add debug logging to protobuf air-gapped support to help diagnose buf.lock detection issues. The CLI now logs the buf.lock path being checked, whether it was found, and detailed error information when buf dep update fails.
3.39.1
(fix): Fix protobuf air-gapped support to properly populate buf cache at build time. Both ProtobufOpenAPIGenerator and ProtobufIRGenerator now always attempt buf dep update first to populate the cache, and only continue on network errors if a pre-cached buf.lock file exists. This ensures dependencies are cached at build time while still supporting air-gapped runtime environments.
3.38.1
(fix): Fix protobuf OpenAPI generation to support air-gapped environments. The CLI now checks for a pre-cached buf.lock file in the proto directory before calling buf dep update. This enables self-hosted deployments with from-openapi: true proto specs to work in air-gapped environments by pre-caching dependencies.
3.38.0
(feat): Add support for parsing response headers from OpenAPI specs. Response headers defined on success responses (2xx) are now captured in the IR and available for SDK generators and documentation.
3.37.6
(chore): Bump IR version to 63.
3.37.5
(fix): Fix fern docs preview delete and fern docs preview list commands to support preview URLs with UUID-style hashes containing hyphens (e.g., org-preview-9b2b47f0-c44b-4338-b579-46872f33404a.docs.buildwithfern.com).
3.37.4
(fix): Fix security: [] handling in OpenAPI importer to correctly mark endpoints as not requiring authentication.
