# What changed in @scalar/api-reference

> 41 changes in @scalar/api-reference 1 from its official release notes, upgrade guides and advisories: 1 breaking, 1 security, 10 new APIs and options. Each one cited. Sources checked 2026-10-24. HTML: https://unstale.sh/npm/@scalar/api-reference/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @scalar/api-reference 1

### Breaking changes

- Removes the duplicate standalone OAuth scope list from operation details; required scopes remain available in the authentication badge popover. (1.76.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1760)

### Security

- Update AI SDK dependencies to address GHSA-866g-f22w-33x8 in response body handling. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)

### New APIs and options

- Adds Copy as Markdown buttons for AsyncAPI channels and operations, with customizable action slots for channels, operations, tags, and introduction. (1.76.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1760)
- Exposes the generate-sdk-button CSS class on the client libraries button. (1.76.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1760)
- Setting urlRouting to false keeps API reference navigation in internal state without reading or changing the host page URL. (1.76.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1760)
- Display server, channel, operation, and message binding details, including versions, referenced bindings, and unfamiliar fields. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)
- Render replies with expandable message schemas, channel links, static addresses, and dynamic reply address expressions. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)
- Display application, server, operation, message, and trait tags, and filter navigation by tags while preserving channel grouping. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)
- Add controls for parameter and schema expansion, model names, required properties, and schema property ordering; explicit toggle overrides of supplied configuration are preserved. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)
- Add per-reference Markdown rendering hooks and apply configured hooks before mounting the embedded client modal so its initial render receives them. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)
- Add an explicitly loaded Mermaid plugin with interactive diagrams, keyboard panning, and zoom controls. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)
- Index operation response schema fields and webhook request/response fields; search nested structures and resolved references with bounded, cycle-safe traversal while ranking field names above descriptive prose. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)

### Behavior and default changes

- Moves navigation cards from tags to channel sections, where each channel's operations are listed beside its details. (1.76.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1760)
- Displays operation-level message payload examples in a dark code card with message and example selection, selectable reply payload examples, and message and reply schemas in the left column. (1.76.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1760)
- Hides SDK generation buttons and the local sidebar promotion when developer tools are disabled. (1.76.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1760)
- AsyncAPI operation layout is aligned with OpenAPI; messages collapse by default, redundant tags are removed, and supported binding schema fields use the shared schema renderer and configured schema options. (1.75.1) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1751)
- AsyncAPI summaries serve as heading and description fallbacks without repeating introductory text. (1.75.1) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1751)
- Display channel summaries and addresses separately, and label missing or null addresses as unknown in channel content and search results. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)
- Display parameter locations alongside descriptions, examples, and constraints. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)
- Display external documentation across AsyncAPI objects, including referenced objects and descriptions, using the existing OpenAPI link presentation. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)
- Display message content types, inherit document defaults, and format examples for their effective media type. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)
- Use customizable Scalar theme styles and an intentional light drawing surface. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)

### Fixes and other changes

- Matches channel badge placement and spacing to OpenAPI modern and classic layouts, using the shared badge component for Send/Receive while preserving arrows and colors. (1.76.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1760)
- Preserves declared AsyncAPI message order in the documentation and example picker. (1.76.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1760)
- Lists reply messages on the operation's own channel only under Replies, rather than repeating them under Messages or Other Channel Messages. (1.76.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1760)
- Displays authored server-variable examples, including examples from referenced variables, in the shared Example/Examples popup with copy support. (1.76.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1760)
- Keeps the response copy button in view when the code scrolls. (1.76.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1760)
- Supports OpenAPI and AsyncAPI context and search results, preserves the selected API description when switching sources, and keeps HTTP execution separate from unsupported messaging actions. (1.75.1) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1751)
- Authentication badge and Markdown copy button wrap on narrow screens instead of extending past the page edge. (1.75.1) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1751)
- Long operation paths wrap instead of being truncated, and the client picker moves below the path when it does not fit. (1.75.1) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1751)
- The button is named by its visible text and described with the tag title. (1.75.1) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1751)
- Endpoint links have an href, enabling keyboard access and modified clicks to open an operation in a new tab. (1.75.1) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1751)
- Endpoint links have a 24px minimum height to meet the WCAG 2.5.8 target size. (1.75.1) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1751)
- Preserve document-backed API key name edits for export, allow clearing configured names, and release configured overrides when restoring the default name. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)
- Keep messages searchable when navigation renders them beneath operations. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)
- Ignore sibling properties when rendering content, navigation, search, and schemas. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)
- Render Avro, Protobuf, and other schema formats as labeled, copyable source instead of dropping them or treating them as JSON Schema. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)
- Render string discriminators with inherited schema variants and effective discriminator values. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)
- Isolate cleanup failures so other plugins still release resources when content changes or unmounts. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)
- Preserve recursive schemas in request bodies, code samples, and response examples instead of replacing recursion points with null or empty arrays. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)
- Prevent shared component styles from overriding host page body backgrounds and margins, including with CSS layers; standalone bundles retain full-page body styling. (1.75.0) — [release notes](https://github.com/scalar/scalar/blob/74361961e3156ef7211395f01c20db733f87ad45/packages/api-reference/CHANGELOG.md#1750)