From f517035e38d62e33b557af12256d02138c2937fe Mon Sep 17 00:00:00 2001
From: "Nolann B." <100787331+nolannbiron@users.noreply.github.com>
Date: Wed, 18 Feb 2026 21:20:58 +0100
Subject: [PATCH] Remove available scopes list from OAuth2 endpoints (#4022)

---
 .changeset/wise-tame-cool.md                         | 5 +++++
 packages/react-openapi/src/OpenAPIRequiredScopes.tsx | 8 ++------
 packages/react-openapi/src/OpenAPISecurities.tsx     | 7 +------
 packages/react-openapi/src/translations/de.ts        | 2 +-
 packages/react-openapi/src/translations/en.ts        | 2 +-
 packages/react-openapi/src/translations/es.ts        | 2 +-
 packages/react-openapi/src/translations/fr.ts        | 2 +-
 packages/react-openapi/src/translations/ja.ts        | 2 +-
 packages/react-openapi/src/translations/nl.ts        | 2 +-
 packages/react-openapi/src/translations/no.ts        | 2 +-
 packages/react-openapi/src/translations/pt-br.ts     | 2 +-
 packages/react-openapi/src/translations/zh.ts        | 2 +-
 12 files changed, 17 insertions(+), 21 deletions(-)
 create mode 100644 .changeset/wise-tame-cool.md

diff --git a/.changeset/wise-tame-cool.md b/.changeset/wise-tame-cool.md
new file mode 100644
index 000000000..20ca0fc4f
--- /dev/null
+++ b/.changeset/wise-tame-cool.md
@@ -0,0 +1,5 @@
+---
+"@gitbook/react-openapi": patch
+---
+
+Remove available scopes list from OAuth2 endpoints when no scopes are required
diff --git a/packages/react-openapi/src/OpenAPIRequiredScopes.tsx b/packages/react-openapi/src/OpenAPIRequiredScopes.tsx
index 6bef0def0..86fc84ba6 100644
--- a/packages/react-openapi/src/OpenAPIRequiredScopes.tsx
+++ b/packages/react-openapi/src/OpenAPIRequiredScopes.tsx
@@ -63,17 +63,13 @@ export function OpenAPIRequiredScopes(props: {
 export function OpenAPISchemaScopes(props: {
     scopes: OpenAPISecurityScope[];
     context: OpenAPIClientContext;
-    isOAuth2?: boolean;
 }) {
-    const { scopes, context, isOAuth2 } = props;
+    const { scopes, context } = props;
 
     return (
         <div className="openapi-securities-scopes openapi-markdown">
             <div className="openapi-required-scopes-description">
-                {t(
-                    context.translation,
-                    isOAuth2 ? 'available_scopes' : 'required_scopes_description'
-                )}
+                {t(context.translation, 'required_scopes_description')}
             </div>
             <ul>
                 {scopes.map((scope) => (
diff --git a/packages/react-openapi/src/OpenAPISecurities.tsx b/packages/react-openapi/src/OpenAPISecurities.tsx
index 6a918dad8..2b1eab836 100644
--- a/packages/react-openapi/src/OpenAPISecurities.tsx
+++ b/packages/react-openapi/src/OpenAPISecurities.tsx
@@ -3,7 +3,7 @@ import { Fragment } from 'react';
 import { InteractiveSection } from './InteractiveSection';
 import { Markdown } from './Markdown';
 import { OpenAPICopyButton } from './OpenAPICopyButton';
-import { OpenAPIRequiredScopes, OpenAPISchemaScopes } from './OpenAPIRequiredScopes';
+import { OpenAPIRequiredScopes } from './OpenAPIRequiredScopes';
 import { OpenAPISchemaName } from './OpenAPISchemaName';
 import type { OpenAPIClientContext } from './context';
 import { t } from './translate';
@@ -176,8 +176,6 @@ function OpenAPISchemaOAuth2Item(props: {
         return null;
     }
 
-    const scopes = !security.scopes?.length && flow.scopes ? Object.entries(flow.scopes) : [];
-
     const description = resolveDescription(security);
 
     return (
@@ -231,9 +229,6 @@ function OpenAPISchemaOAuth2Item(props: {
                         </OpenAPICopyButton>
                     </span>
                 ) : null}
-                {scopes.length ? (
-                    <OpenAPISchemaScopes scopes={scopes} context={context} isOAuth2 />
-                ) : null}
             </div>
         </div>
     );
diff --git a/packages/react-openapi/src/translations/de.ts b/packages/react-openapi/src/translations/de.ts
index 87d30d3d1..703e1fb82 100644
--- a/packages/react-openapi/src/translations/de.ts
+++ b/packages/react-openapi/src/translations/de.ts
@@ -38,7 +38,7 @@ export const de = {
     available_items: 'Verfügbare Elemente',
     required_scopes: 'Erforderliche Scopes',
     required_scopes_description: 'Dieser Endpunkt erfordert die folgenden Scopes:',
-    available_scopes: 'Verfügbare Scopes:',
+
     properties: 'Eigenschaften',
     or: 'oder',
     and: 'und',
diff --git a/packages/react-openapi/src/translations/en.ts b/packages/react-openapi/src/translations/en.ts
index 3c575f7cd..c6079979e 100644
--- a/packages/react-openapi/src/translations/en.ts
+++ b/packages/react-openapi/src/translations/en.ts
@@ -38,7 +38,7 @@ export const en = {
     available_items: 'Available items',
     required_scopes: 'Required scopes',
     required_scopes_description: 'This endpoint requires the following scopes:',
-    available_scopes: 'Available scopes:',
+
     possible_values: 'Possible values',
     properties: 'Properties',
     or: 'or',
diff --git a/packages/react-openapi/src/translations/es.ts b/packages/react-openapi/src/translations/es.ts
index bb4f7372f..044b72a24 100644
--- a/packages/react-openapi/src/translations/es.ts
+++ b/packages/react-openapi/src/translations/es.ts
@@ -38,7 +38,7 @@ export const es = {
     available_items: 'Elementos disponibles',
     required_scopes: 'Scopes requeridos',
     required_scopes_description: 'Este endpoint requiere los siguientes scopes:',
-    available_scopes: 'Scopes disponibles:',
+
     properties: 'Propiedades',
     or: 'o',
     and: 'y',
diff --git a/packages/react-openapi/src/translations/fr.ts b/packages/react-openapi/src/translations/fr.ts
index fff5723c3..1bbfc0fc0 100644
--- a/packages/react-openapi/src/translations/fr.ts
+++ b/packages/react-openapi/src/translations/fr.ts
@@ -38,7 +38,7 @@ export const fr = {
     available_items: 'Éléments disponibles',
     required_scopes: 'Scopes requis',
     required_scopes_description: 'Cet endpoint nécessite les scopes suivants:',
-    available_scopes: 'Scopes disponibles:',
+
     properties: 'Propriétés',
     or: 'ou',
     and: 'et',
diff --git a/packages/react-openapi/src/translations/ja.ts b/packages/react-openapi/src/translations/ja.ts
index cf5f05b70..ae39295ae 100644
--- a/packages/react-openapi/src/translations/ja.ts
+++ b/packages/react-openapi/src/translations/ja.ts
@@ -38,7 +38,7 @@ export const ja = {
     available_items: '利用可能なアイテム',
     required_scopes: '必須スコープ',
     required_scopes_description: 'このエンドポイントには次のスコープが必要です：',
-    available_scopes: '利用可能なスコープ：',
+
     properties: 'プロパティ',
     or: 'または',
     and: 'かつ',
diff --git a/packages/react-openapi/src/translations/nl.ts b/packages/react-openapi/src/translations/nl.ts
index ce37c6696..0d23c851c 100644
--- a/packages/react-openapi/src/translations/nl.ts
+++ b/packages/react-openapi/src/translations/nl.ts
@@ -38,7 +38,7 @@ export const nl = {
     available_items: 'Beschikbare items',
     required_scopes: 'Vereiste scopes',
     required_scopes_description: 'Dit endpoint vereist de volgende scopes:',
-    available_scopes: 'Beschikbare scopes:',
+
     properties: 'Eigenschappen',
     or: 'of',
     and: 'en',
diff --git a/packages/react-openapi/src/translations/no.ts b/packages/react-openapi/src/translations/no.ts
index ca42bf6d9..85ce037a7 100644
--- a/packages/react-openapi/src/translations/no.ts
+++ b/packages/react-openapi/src/translations/no.ts
@@ -38,7 +38,7 @@ export const no = {
     available_items: 'Tilgjengelige elementer',
     required_scopes: 'Påkrevde scopes',
     required_scopes_description: 'Dette endepunktet krever følgende scopes:',
-    available_scopes: 'Tilgjengelige scopes:',
+
     properties: 'Egenskaper',
     or: 'eller',
     and: 'og',
diff --git a/packages/react-openapi/src/translations/pt-br.ts b/packages/react-openapi/src/translations/pt-br.ts
index c0548180a..8603f21ba 100644
--- a/packages/react-openapi/src/translations/pt-br.ts
+++ b/packages/react-openapi/src/translations/pt-br.ts
@@ -38,7 +38,7 @@ export const pt_br = {
     available_items: 'Itens disponíveis',
     required_scopes: 'Scopes obrigatórios',
     required_scopes_description: 'Este endpoint requer os seguintes scopes:',
-    available_scopes: 'Scopes disponíveis:',
+
     properties: 'Propriedades',
     or: 'ou',
     and: 'e',
diff --git a/packages/react-openapi/src/translations/zh.ts b/packages/react-openapi/src/translations/zh.ts
index 02b7aca59..be8913d58 100644
--- a/packages/react-openapi/src/translations/zh.ts
+++ b/packages/react-openapi/src/translations/zh.ts
@@ -38,7 +38,7 @@ export const zh = {
     available_items: '可用项',
     required_scopes: '必需范围',
     required_scopes_description: '此端点需要以下范围：',
-    available_scopes: '可用范围：',
+
     properties: '属性',
     or: '或',
     and: '和',