Skip to content

Commit 34086f3

Browse files
committed
document resolve-aliases
1 parent d9c549b commit 34086f3

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

fern/snippets/openapi-specs.mdx

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -117,3 +117,18 @@ api:
117117
Disabled by default to maintain backwards compatibility.
118118

119119
</ParamField>
120+
121+
<ParamField path="resolve-aliases" type="boolean" default="false" toc={true}>
122+
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.
123+
124+
You can preserve specific aliases by adding an `except` array listing the type names to keep as separate types. For example:
125+
126+
```yaml
127+
settings:
128+
resolve-aliases:
129+
except:
130+
- UserId
131+
- OrganizationId
132+
```
133+
134+
</ParamField>

0 commit comments

Comments
 (0)