Use the x-fern-sdk-group-name and x-fern-sdk-method-name extensions to control how endpoints are organized in your SDKs and CLIs.
Fern automatically parses operationId
If no extensions are present, Fern uses your operation ID to generate SDK method names. Format operation IDs as {tag_name}_{operation_name} (example: users_get) to automatically generate methods like users.get(). If the operation ID doesn’t start with a tag, Fern uses it directly as the method name.
In the example below, Fern will generate a
method called client.users.create() for the POST /users endpoint.
If you omit the x-fern-sdk-group-name extension, the generated SDK method
will live at the root of the client rather than nested under a resource group.
In the example below, Fern will generate a method called client.send():
See how merge.dev uses nested groups here.
If you add more than one x-fern-sdk-group-name extension, then the generated SDK will nest group names.
The generated SDK method preserves the order of group names.
In the example below, Fern will generate a method called client.users.notifications.send():