diff --git a/fern/products/docs/pages/developer-tools/openapi-spec.mdx b/fern/products/docs/pages/developer-tools/openapi-spec.mdx index 635475b66..90f9cedba 100644 --- a/fern/products/docs/pages/developer-tools/openapi-spec.mdx +++ b/fern/products/docs/pages/developer-tools/openapi-spec.mdx @@ -18,7 +18,7 @@ Every Fern docs site exposes the OpenAPI specification at these paths: | `/openapi.yaml` | YAML | `application/x-yaml` | | `/openapi.yml` | YAML | `application/x-yaml` | -The spec includes your endpoints with request/response schemas, authentication schemes (Bearer, Basic, API Key, OAuth), webhooks, type definitions as component schemas, and server URLs from your environment configuration. The [`info.version`](/learn/api-definitions/openapi/extensions/api-version) field from your source spec is preserved as-is, including non-SemVer formats like CalVer. The spec is generated from the same API definition that powers your docs, so it's always up to date. +The spec includes your endpoints with request/response schemas, authentication schemes (Bearer, Basic, API Key, OAuth), webhooks, type definitions as component schemas, server URLs from your environment configuration, and top-level tags with descriptions. The [`info.version`](/learn/api-definitions/openapi/extensions/api-version) field from your source spec is preserved as-is, including non-SemVer formats like CalVer. The spec is generated from the same API definition that powers your docs, so it's always up to date. Endpoints and API references marked `hidden: true` are excluded.