Add OpenAPI servers selection

[nolannbiron]

Demo

[linear]

RND-8383 Display different servers in the OpenAPI block

[changeset-bot]

🦋 Changeset detected

Latest commit: befda7d

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

[github-actions]

Summary of the deployments:

Version	URL	Status
Vercel	https://gitbook-v2-gotw1i8h6-gitbook.vercel.app	✅
Cloudflare	https://f1207265-gitbook-open-v2-preview.gitbook.workers.dev	✅

Test content

Site	2v	2c
GitBook	https://gitbook-v2-gotw1i8h6-gitbook.vercel.app/url/gitbook.com/docs	https://f1207265-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs
E2E	https://gitbook-v2-gotw1i8h6-gitbook.vercel.app/url/gitbook.gitbook.io/test-gitbook-open	https://f1207265-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	4 changed, 4 added	Oct 16, 2025, 10:41 AM
v2-cloudflare (Inspect)	👍 Changes approved	5 changed	Oct 16, 2025, 10:45 AM
v2-vercel (Inspect)	👍 Changes approved	8 changed	Oct 16, 2025, 10:44 AM

[Copilot]

Pull Request Overview

This PR adds OpenAPI servers selection functionality that allows users to choose between multiple servers in an OpenAPI specification. The implementation includes a dropdown selector for servers when multiple servers are available, with enhanced UI components for better user experience.

• Refactored OpenAPIPath component to support multiple servers with a new server selection interface
• Added new UI components including OpenAPITooltip, OpenAPIPathItem, and OpenAPIPathMultipleServers for improved modularity
• Enhanced OpenAPISelect component with better icon handling and styling options

Reviewed Changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
packages/react-openapi/src/types.ts	Added optional name property to OpenAPIServerWithCustomProperties type
packages/react-openapi/src/formatPath.tsx	Extracted path formatting logic into standalone utility function
packages/react-openapi/src/context.ts	Added copy and check icons to OpenAPIClientContext interface
packages/react-openapi/src/OpenAPITooltip.tsx	New tooltip component wrapper around react-aria-components
packages/react-openapi/src/OpenAPISelect.tsx	Enhanced select component with improved icon handling and prop updates
packages/react-openapi/src/OpenAPIPathMultipleServers.tsx	New component for handling multiple server selection with dropdown
packages/react-openapi/src/OpenAPIPathItem.tsx	New shared component for rendering path items with copy functionality
packages/react-openapi/src/OpenAPIPath.tsx	Refactored to use new components and support multiple servers
packages/react-openapi/src/OpenAPIDisclosureGroup.tsx	Updated to use new onChange prop instead of onSelectionChange
packages/react-openapi/src/OpenAPICopyButton.tsx	Updated to use new OpenAPITooltip component
packages/react-openapi/src/OpenAPICodeSampleInteractive.tsx	Simplified MediaTypeSelector implementation
packages/react-openapi/src/InteractiveSection.tsx	Updated to use new onChange prop instead of onSelectionChange
packages/gitbook/src/components/DocumentView/OpenAPI/style.css	Added styles for new components and improved path display
packages/gitbook/src/components/DocumentView/OpenAPI/context.tsx	Added copy and check icons to context

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}