August 14, 2025 | Fern Documentation

0.66.15

(feat): Split OpenAPI endpoints with multiple request bodies into multiple endpoints using x-fern-sdk-method-name. For example, take the following OpenAPI spec:

1 paths:
2   /documents/upload:
3     post:
4       summary: Upload document metadata (JSON) or document file
5       operationId: uploadDocument
6       requestBody:
7         content:
8           application/json:
9             x-fern-sdk-method-name: uploadJsonDocument
10             schema:
11               type: object
12               properties:
13                 title:
14                   type: string
15                 author:
16                   type: string
17                 tags:
18                   type: array
19                   items:
20                     type: string
21           application/pdf:
22             x-fern-sdk-method-name: uploadPdfDocument
23             schema:
24               type: string
25               format: binary

The OpenAPI spec becomes the following Fern Definition:

1 service:
2   endpoints:
3     uploadJsonDocument:
4       method: POST
5       path: /documents/upload
6       request:
7         body:
8           properties:
9             author: optional<string>
10             tags: optional<list<string>>
11             title: optional<string>
12         content-type: application/json
13         name: UploadDocumentRequest
14         ...
15     uploadPdfDocument:
16       method: POST
17       path: /documents/upload
18       request:
19         body: bytes
20         content-type: application/pdf
21       ...