diff --git a/fern/snippets/openapi-specs.mdx b/fern/snippets/openapi-specs.mdx
index 27d7aad75..ffb13cb73 100644
--- a/fern/snippets/openapi-specs.mdx
+++ b/fern/snippets/openapi-specs.mdx
@@ -13,6 +13,7 @@ api:
         inline-all-of-schemas: true
         prefer-undiscriminated-unions-with-literals: true
         respect-parameter-content: true
+        respect-operation-id-word-boundaries: true
         filter:
           endpoints: ["POST /users", "GET /users/{id}"]
         example-generation:
@@ -138,6 +139,12 @@ api:
   Enables respecting forward compatible enums in OpenAPI specifications.
 </ParamField>
 
+<ParamField path="settings.respect-operation-id-word-boundaries" type="boolean" default="false" toc={true}>
+  Splits an `operationId` on separators, camelCase transitions, and digits when building API Reference URL slugs, and strips the tag prefix. When `false`, an `operationId` that contains an underscore or digit is split only on separators, so `Plants_ListPlantVarieties` under the `plants` tag becomes `/plants/listplantvarieties` instead of `/plants/list-plant-varieties`. Affects API Reference URLs only; generated SDK method names are unchanged.
+
+  Enabling this setting moves existing API Reference URLs. Add [redirects](/learn/docs/seo/redirects) for the old paths and update hardcoded links in the same change.
+</ParamField>
+
 <ParamField path="settings.use-bytes-for-binary-response" type="boolean" toc={true}>
   Enables using the `bytes` type for binary responses. Defaults to file stream.
 </ParamField>