diff --git a/fern/products/sdks/reference/generators-yml-reference.mdx b/fern/products/sdks/reference/generators-yml-reference.mdx
index 219983e68..5c07b7f48 100644
--- a/fern/products/sdks/reference/generators-yml-reference.mdx
+++ b/fern/products/sdks/reference/generators-yml-reference.mdx
@@ -202,7 +202,7 @@ api:
- Namespace for the specification.
+ Namespace for the specification. Useful for configuring a [single package with multiple API versions](/api-definitions/overview/project-structure#option-2-namespace-based-versioning).
@@ -220,6 +220,10 @@ api:
Preserves nullable schemas in API definition settings. When false, nullable schemas are treated as optional.
+
+ When enabled, groups servers by host into unified environments, enabling APIs with multiple protocols (REST, WebSocket, etc.) to share environment configuration. Environment URL IDs use the server name, with path or protocol suffixes added only when needed to resolve collisions.
+
+
@@ -264,7 +268,7 @@ api:
-```yaml
+```yaml title="generators.yml"
api:
specs:
conjure: "./conjure-api.yml"
diff --git a/fern/snippets/openapi-specs.mdx b/fern/snippets/openapi-specs.mdx
index cf0c84310..e225184dc 100644
--- a/fern/snippets/openapi-specs.mdx
+++ b/fern/snippets/openapi-specs.mdx
@@ -30,10 +30,10 @@ api:
- Namespace for the specification.
+ Namespace for the specification. Useful for configuring a [single package with multiple API versions](/api-definitions/overview/project-structure#option-2-namespace-based-versioning).
-
+
OpenAPI-specific generation settings.
@@ -41,84 +41,84 @@ api:
Whether to use the titles of schemas within an OpenAPI definition as the names of types within Fern.
-
+
Whether to include path parameters within the generated in-lined request.
-
+
Whether to inline `allOf` schemas during code generation. When true, Fern recursively visits `allOf` schema definitions and inlines them into the child schema. When false, `allOf` schemas are extended through inheritance.
Enabling this setting allows child schemas to override parent property requirements. For example, a child schema can mark a parent's required property as optional. Without this setting, Fern ignores the child schema's optional declaration and preserves the parent schema's requirement instead.
-
+
Whether to prefer undiscriminated unions with literals.
-
+
Whether to only include schemas referenced by endpoints in the generated SDK (tree-shaking).
-
+
Preserves nullable schemas in API definition settings. When false, nullable schemas are treated as optional.
-
+
Enables parsing deep object query parameters.
-
+
Enables exploring readonly schemas in OpenAPI specifications.
-
+
Enables respecting forward compatible enums in OpenAPI specifications.
-
+
Enables using the `bytes` type for binary responses. Defaults to file stream.
-
+
The default encoding of form parameters. Options: `form`, `json`.
-
+
Configure what `additionalProperties` should default to when not explicitly defined on a schema.
-
+
If true, convert strings with format date to strings. If false, convert to dates.
-
+
If true, preserve oneOf structures with a single schema. If false, unwrap them.
-
+
Endpoints to include in the generated SDK (e.g., "POST /users").
-
+
Controls the maximum depth for which optional properties will have examples generated. A depth of 0 means no optional properties will have examples.
-
+
Controls the maximum depth for which optional properties will have examples generated in responses.
-
+
Controls whether enums are converted to literal types during code generation. When set to `false`, enums are preserved as enums rather than being converted to literal types. This is useful when you want to maintain the original enum structure from your OpenAPI specification.
-
+
Controls the naming convention for autogenerated request names. When enabled, places the verb before the noun in request names (e.g., `UsersListRequest` becomes `ListUsersRequest`), following more idiomatic naming patterns.
Disabled by default to maintain backwards compatibility.
-
+
Inlines type aliases to simplify your generated SDK. When enabled, reduces
unnecessary type definitions by replacing simple aliases with their underlying
types directly. Useful for OpenAPI specs with many primitive or simple type
@@ -139,3 +139,7 @@ api:
- OrganizationId
```
+
+ When enabled, groups servers by host into unified environments, enabling APIs with multiple protocols (REST, WebSocket, etc.) to share environment configuration. Environment URL IDs use the server name, with path or protocol suffixes added only when needed to resolve collisions.
+
+