Re-arrange OpenAPI Scopes for OAuth2

[nolannbiron]

Only show endpoint scopes in Required scopes. For OAuth2, add Available scopes back to the Authorization section if no endpoint scopes are present.

[changeset-bot]

🦋 Changeset detected

Latest commit: c87eda1

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@gitbook/react-openapi	Patch
gitbook	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[Copilot]

Pull Request Overview

This PR reorganizes how OAuth2 scopes are displayed in the OpenAPI documentation interface by introducing a new "available scopes" section that shows all scopes defined in OAuth2 flows when no specific scopes are required for a security scheme.

Key Changes:

• Added "available_scopes" translation key across all supported languages
• Modified OpenAPISchemaScopes to support both required and available scopes display modes
• Updated OAuth2 security display logic to show available scopes when no specific scopes are required

Reviewed Changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 1 comment.

File	Description
packages/react-openapi/src/OpenAPIRequiredScopes.tsx	Made OpenAPISchemaScopes component public and added support for OAuth2 available scopes display mode
packages/react-openapi/src/OpenAPISecurities.tsx	Added logic to display available scopes from OAuth2 flows when no specific scopes are required
packages/react-openapi/src/translations/*.ts	Added "available_scopes" translation key for 8 languages (en, de, es, fr, ja, nl, no, pt-br, zh)
.changeset/calm-shirts-tie.md	Added changeset documenting the OAuth2 scopes reorganization

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[github-actions]

Summary of the deployments:

Version	URL	Status
Vercel	https://gitbook-v2-2pndosnq0-gitbook.vercel.app	✅
Cloudflare	https://0508b1a4-gitbook-open-v2-preview.gitbook.workers.dev	✅

Test content

Site	2v	2c
GitBook	https://gitbook-v2-2pndosnq0-gitbook.vercel.app/url/gitbook.com/docs	https://0508b1a4-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs
E2E	https://gitbook-v2-2pndosnq0-gitbook.vercel.app/url/gitbook.gitbook.io/test-gitbook-open	https://0508b1a4-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.gitbook.io/test-gitbook-open

[argos-ci]

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
customers-v2 (Inspect)	👍 Changes approved	28 changed	Nov 12, 2025, 6:31 PM
v2-cloudflare (Inspect)	👍 Changes approved	3 changed	Nov 12, 2025, 6:35 PM
v2-vercel (Inspect)	👍 Changes approved	3 changed	Nov 12, 2025, 6:34 PM