document resolve-aliases

Author: devalog

fern/snippets/openapi-specs.mdx

@@ -117,3 +117,18 @@ api:
   Disabled by default to maintain backwards compatibility.
 
 </ParamField>
+
+<ParamField path="resolve-aliases" type="boolean" default="false" toc={true}>
+  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 aliases.
+
+  You can preserve specific aliases by adding an `except` array listing the type names to keep as separate types. For example:
+
+  ```yaml
+  settings:
+    resolve-aliases:
+      except:
+        - UserId
+        - OrganizationId
+  ```
+
+</ParamField>