From 43e9f1abdeaf91cff22795ea667f8a3ce79ff966 Mon Sep 17 00:00:00 2001
From: "will.kendall" <will.kendall@postman.com>
Date: Wed, 16 Sep 2026 18:31:27 +0000
Subject: [PATCH] docs(docs-yml): document settings.show-headers-in-examples

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
---
 fern/products/docs/pages/navigation/site-level-settings.mdx | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/fern/products/docs/pages/navigation/site-level-settings.mdx b/fern/products/docs/pages/navigation/site-level-settings.mdx
index b2cb6c60f..ead65ed19 100644
--- a/fern/products/docs/pages/navigation/site-level-settings.mdx
+++ b/fern/products/docs/pages/navigation/site-level-settings.mdx
@@ -748,6 +748,7 @@ settings:
     prioritize-current-product: true
     default-filter-by-current-product: true
   http-snippets: false
+  show-headers-in-examples: false
   hide-404-page: true
   use-javascript-as-typescript: false
   folder-title-source: frontmatter
@@ -809,6 +810,10 @@ settings:
 ```
 </ParamField>
 
+<ParamField path="settings.show-headers-in-examples" type="boolean" required={false} default="false" toc={true}>
+  If set to true, response examples in the API Reference include a raw HTTP block listing the response's declared headers — the status line plus one `Name: value` line per header — above the response body. Responses whose spec declares no headers render unchanged.
+</ParamField>
+
 <ParamField path="settings.hide-404-page" type="boolean" required={false} default="false" toc={true}>
   If set to true, when a user navigates to a page that doesn't exist, they will be redirected to the home page.