CLI reference

Changelog

August 14, 2025

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:

1paths:
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:

1service:
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      ...