From 98e42cfe7910f85334bca9d3871e1336d15b7b8c Mon Sep 17 00:00:00 2001
From: "Nolann B." <100787331+nolannbiron@users.noreply.github.com>
Date: Mon, 1 Sep 2025 14:25:35 +0200
Subject: [PATCH] Handle OpenAPI ignored responses (#3614)

---
 .changeset/shaggy-crabs-return.md                     | 5 +++++
 packages/react-openapi/src/OpenAPIResponseExample.tsx | 8 +++++++-
 2 files changed, 12 insertions(+), 1 deletion(-)
 create mode 100644 .changeset/shaggy-crabs-return.md

diff --git a/.changeset/shaggy-crabs-return.md b/.changeset/shaggy-crabs-return.md
new file mode 100644
index 000000000..e5c708b89
--- /dev/null
+++ b/.changeset/shaggy-crabs-return.md
@@ -0,0 +1,5 @@
+---
+'@gitbook/react-openapi': patch
+---
+
+Handle OpenAPI ignored responses
diff --git a/packages/react-openapi/src/OpenAPIResponseExample.tsx b/packages/react-openapi/src/OpenAPIResponseExample.tsx
index 79052c63e..945ace4f1 100644
--- a/packages/react-openapi/src/OpenAPIResponseExample.tsx
+++ b/packages/react-openapi/src/OpenAPIResponseExample.tsx
@@ -42,7 +42,13 @@ export function OpenAPIResponseExample(props: {
     });
 
     const tabs = responses
-        .filter(([_, responseObject]) => responseObject && typeof responseObject === 'object')
+        .filter(
+            ([_, responseObject]) =>
+                responseObject &&
+                typeof responseObject === 'object' &&
+                // Make sure the response is not hidden
+                !responseObject['x-hideSample']
+        )
         .map(([key, responseObject]) => {
             const description = resolveDescription(responseObject);
             const label = description ? (