PackageTrack

npm

@scalar/api-reference

1.67.0scalar/scalar

Generate beautiful API references from OpenAPI documents

Release timeline

705 releases since 2023
20232026

One column per quarter.

Releases

  1. 1.39.39 Nov 2025
    Release notes

    Patch Changes

    Open source →
  2. 1.39.26 Nov 2025
    Release notes

    Patch Changes

    Open source →
  3. 1.39.14 Nov 2025
    Release notes

    Patch Changes

    Open source →
  4. 1.39.03 Nov 2025
    Release notes

    Minor Changes

    • #7129 6ec8c29 Thanks @geoffgscott! - Simplify ApiReferences state management and migrate to new shared sidebar component. Eliminates the useSidebar and useNav hooks in favour of event bubbling and centralized state management in ApiReference.vue

    • #7094 eba18d0 Thanks @geoffgscott! - Migrate to workspace store as primary source of truth.

    • #7199 0d9c945 Thanks @marcalexiei! - feat: update vue to 3.5.21

    Patch Changes

    Open source →
  5. 1.38.114 Oct 2025
    Release notes

    Patch Changes

    Open source →
  6. 1.38.08 Oct 2025
    Release notes

    Minor Changes

    • 1e01464: Adds a new ApiReferenceConfigWithSource type and make the base ApiReferenceConfig type agnostic of any document sources.

    Patch Changes

    Open source →
  7. 1.37.02 Oct 2025
    Release notes

    Minor Changes

    • 008a0f3: feat: migrate to Zod 4

    Patch Changes

    Open source →
  8. 1.36.229 Sept 2025
    Release notes

    Patch Changes

    Open source →
  9. 1.36.126 Sept 2025
    Release notes

    Patch Changes

    Open source →
  10. 1.36.023 Sept 2025
    Release notes

    Minor Changes

    • 003bb98: Fix server selection for examples/snippets in Operation: prefer operation-level servers, then path-level servers, then provided server prop.

    Patch Changes

    Open source →
  11. 1.35.719 Sept 2025
    Release notes

    Patch Changes

    Open source →
  12. 1.35.615 Sept 2025
    Release notes

    Patch Changes

    Open source →
  13. 1.35.513 Sept 2025
    Release notes

    Patch Changes

    Open source →
  14. 1.35.412 Sept 2025
    Release notes

    Patch Changes

    Open source →
  15. 1.35.310 Sept 2025
    Release notes

    Patch Changes

    Open source →
  16. 1.35.29 Sept 2025
    Release notes

    Patch Changes

    Open source →
  17. 1.35.19 Sept 2025
    Release notes

    Patch Changes

    Open source →
  18. 1.35.08 Sept 2025
    Release notes

    Minor Changes

    • 697f1d0: feat(api-reference): info block
    • 5ad329e: feat: openapi auth selector block

    Patch Changes

    • 714b197: feat: support base64 unicode characters
    • 792c937: Configurable option for sidebar to show method path instead of method summary.
    • f918582: feat(api-reference, components): update scalar floating components contraints
    • 549eb02: feat(api-reference): export workspace store hooks
    • 3473e08: fix: performance issues on script load
    • a6ae22a: feat: change the way we declare schemas
    • 94e4762: fix: padding on intro block
    • d5c1d0c: feat(api-reference): custom display for webhook request examples
    • 2077f01: fix: open first tag when not defined in document
    • 0e747c7: fix: initial scroll to id lands in random positions
    • Updated dependencies [ba27329]
    • Updated dependencies [714b197]
    • Updated dependencies [40e79b9]
    • Updated dependencies [06a46f0]
    • Updated dependencies [98c55d0]
    • Updated dependencies [792c937]
    • Updated dependencies [f918582]
    • Updated dependencies [cededd8]
    • Updated dependencies [3473e08]
    • Updated dependencies [a6ae22a]
    • Updated dependencies [422cb2b]
    • Updated dependencies [63283aa]
    • Updated dependencies [8680da6]
    • Updated dependencies [ee605d8]
    • Updated dependencies [2b22eab]
    • Updated dependencies [0e747c7]
    • Updated dependencies [976366f]
    • Updated dependencies [99894bc]
    • Updated dependencies [5ad329e]
    Open source →
  19. 1.34.625 Aug 2025
    Release notes

    Patch Changes

    Open source →
  20. 1.34.525 Aug 2025
    Release notes

    Patch Changes

    Open source →
  21. 1.34.422 Aug 2025
    Release notes

    Patch Changes

    • bbef120: fix: remove extra coerces and cleanUp plugin from bundler
    • 24883ab: feat(api-reference): map reference configuration to the new store configuration
    • a1429ca: chore: move to new extensions system for better type safety
    • e499aee: fix: typo in model opening
    • 845e850: fix: deep resolve response examples
    • 66b18fc: feat: update the references to handle $refs from the magic proxy
    • 6eb7c4f: fix: search does not match when the query has a single character word
    • 4e06829: fix: horizontal scrollbars in a VS Code webview
    • 5f022b5: feat: use registry.scalar.com URLs as example
    • 2b89e6f: feat: x-badges
    • 6a88108: feat: add option to expandAllResponses and expandAllModelSections
    • c838a3f: chore: added measurements to workspace store
    • 75d84ed: fix: does not load document when the url/content stays the same
    • 929df42: fix: sidebar links are prefixed with the path
    • 0804cfc: eat(components): Add ScalarMarkdown summary component
    • Updated dependencies [bbef120]
    • Updated dependencies [b93e1fe]
    • Updated dependencies [a1429ca]
    • Updated dependencies [d4adeba]
    • Updated dependencies [5208f06]
    • Updated dependencies [172e397]
    • Updated dependencies [4d509fb]
    • Updated dependencies [66b18fc]
    • Updated dependencies [5f022b5]
    • Updated dependencies [0fcd446]
    • Updated dependencies [d8b8a5b]
    • Updated dependencies [6c24be9]
    • Updated dependencies [6a88108]
    • Updated dependencies [c838a3f]
    • Updated dependencies [c418e92]
    • Updated dependencies [9be6eec]
    • Updated dependencies [c4bf497]
    • Updated dependencies [638120c]
    • Updated dependencies [d8adbed]
    • Updated dependencies [0804cfc]
    • Updated dependencies [0c80ef0]
    Open source →
  22. 1.34.23 Aug 2025
    Release notes

    Patch Changes

    • 83625c6: fix: cyclic error in client store watcher
    Open source →
  23. 1.34.12 Aug 2025
    Release notes

    Patch Changes

    Open source →
  24. 1.34.01 Aug 2025
    Release notes

    Minor Changes

    • 2888e18: feat(openapi-parser): partial bundle to a depth

    Patch Changes

    • f838a47: feat: link to parameters
    • 94b5d0a: fix: show description when merging allOf properties
    • 0f4a784: fix(api-references): constrain specificity for top level schema properties
    • 5301a80: feat: make content reactive and update workspace store
    • 8113963: refactor: use new data structure for the search
    • fb0c254: fix: lazy loading for maximum loading performance
    • Updated dependencies [952bde2]
    • Updated dependencies [46ebe6e]
    • Updated dependencies [5301a80]
    • Updated dependencies [c02c1c8]
    • Updated dependencies [ae8d1b9]
    • Updated dependencies [b551707]
    • Updated dependencies [8199955]
    • Updated dependencies [dd00357]
    • Updated dependencies [2888e18]
    Open source →
  25. 1.33.029 Jul 2025
    Release notes

    Minor Changes

    • 2e2f50a: refactor: new main content rendering

    Patch Changes

    • 14a737c: feat: add a max height to the operation list
    • 628d44c: fix: ensure intersection observer is enabled when no hash.value
    • 092626d: fix: the order of the client libraries
    • 9c157f1: fix: misalignments in sidebar element icon and title
    • ce9b7ff: fix: increases download link stackking to preserve clickability
    • f65f1fc: feat: updates content type select style and position
    • 4ea9dab: feat: Make the min & max descriptions more descriptive for strings
    • 8d24b91: fix: updates schema enum property style handling
    • 7031d9c: fix(api-reference): reference theme and style fixes
    • 1913f97: feat: merge schema root properties into composition schemas
    • 0f41af6: fix: show anyOf schema when only one item with no type
    • 956a2d1: feat: updates heading anchor style to use latest icons
    • 7ee81f4: fix: can not render operation without responses
    • 94d6d0c: fix: remove old ssr state and update nuxt for workspace store
    • d29c455: fix: select shell/curl as default client lib
    • 319fb56: fix(api-reference): center show schema checkmark
    • 24c9d4c: feat: convert links list to icons only if it needs to scroll
    • c0d6793: feat: ensure we use the path routing base path for relative document url resolution
    • 6953c9f: fix: updates example response schema checkbox style
    • 72924f6: fix: linking to models from search
    • 6f12d2e: fix: hiddenClients config option
    • 8795629: fix: classic layout intersection observer
    • 515162c: fix: adds replaceDocument to createMockStore
    • f3d0216: feat: lazy loading v1.5
    • 7555e44: feat(api-reference): add combobox to client libraries card
    • af22451: feat: increases caret icon usage and style concistency amongst reference and client
    • a5534e6: fix: show path parameters on operation
    • 6b6c72c: fix: hiddenClients: true and move clients to workspace store
    • Updated dependencies [ccf875a]
    • Updated dependencies [fbef7e1]
    • Updated dependencies [f913898]
    • Updated dependencies [9924c47]
    • Updated dependencies [cf5d6a2]
    • Updated dependencies [d4cb86b]
    • Updated dependencies [94d6d0c]
    • Updated dependencies [c345d2c]
    • Updated dependencies [8c731b9]
    • Updated dependencies [952f471]
    • Updated dependencies [a0c92d9]
    • Updated dependencies [1af32c0]
    • Updated dependencies [8c731b9]
    • Updated dependencies [c0d6793]
    • Updated dependencies [77e700b]
    • Updated dependencies [b957a2c]
    • Updated dependencies [3c1e3e3]
    • Updated dependencies [f3d0216]
    • Updated dependencies [af22451]
    • Updated dependencies [a5534e6]
    • Updated dependencies [6b6c72c]
    Open source →
  26. 1.32.1021 Jul 2025
    Release notes

    Patch Changes

    • 3eb8171: fix: value in request example code
    • 60c7bef: fix: updates auth description overflowing line clamp
    • 716a83a: refactor: new request example block
    • 9b4417b: fix: removes unsused prop in layout for request example
    • 2ace00b: fix: prevents introduction card dropdown stacking issue
    • fb62e1b: feat: render External Documentation Objects
    • cac47ea: fix: updates request auth border radius
    • 2ace00b: fix: increases server variables label input font size
    • Updated dependencies [60c7bef]
    • Updated dependencies [e895f86]
    • Updated dependencies [fb62e1b]
    • Updated dependencies [cac47ea]
    • Updated dependencies [fb62e1b]
    • Updated dependencies [1c2b9f3]
    • Updated dependencies [cac47ea]
    Open source →
  27. 1.32.916 Jul 2025
    Release notes

    Patch Changes

    • 8c6f6fe: fix: rollback workspace store
    Open source →
  28. 1.32.816 Jul 2025
    Release notes

    Patch Changes

    • a04cc15: feat(components): create scalar card component
    • b5bcce7: feat: implement new request example openapi block in references
    • 97721b5: fix: prevents navigation on enter in search modal if no result
    • 9978a16: fix: example response has an additional value key
    • 8a67f4f: fix(api-reference): classic layout improvements
    • Updated dependencies [a04cc15]
    • Updated dependencies [591562f]
    • Updated dependencies [85ee2ce]
    • Updated dependencies [fbb7daa]
    • Updated dependencies [3f2ea8a]
    • Updated dependencies [fbaaa12]
    • Updated dependencies [828c894]
    • Updated dependencies [85ee2ce]
    • Updated dependencies [97721b5]
    • Updated dependencies [b5bcce7]
    • Updated dependencies [85ee2ce]
    • Updated dependencies [8a67f4f]
    Open source →
  29. 1.32.713 Jul 2025
    Release notes

    Patch Changes

    • a85480e: feat: lay the groundwork for the block implementation PR
    • 1a6c0a4: feat: increases property font sizes + updates description color
    • 9be7ca9: fix: show description for expandable enum values
    • c2ff19e: fix: updates enum values style
    • 7325520: feat: render additionalProperties and patternProperties
    • 134c455: fix: updates example request selected type presence check for discriminator
    • Updated dependencies [a85480e]
    • Updated dependencies [934dff9]
    • Updated dependencies [8b9c48e]
    • Updated dependencies [6ab3a21]
    • Updated dependencies [71958fd]
    Open source →
  30. 1.32.610 Jul 2025
    Release notes

    Patch Changes

    Open source →
  31. 1.32.57 Jul 2025
    Release notes

    Patch Changes

    • 5de7e25: fix: classic layout does not show request body
    Open source →
  32. 1.32.47 Jul 2025
    Release notes

    Patch Changes

    • b420f18: fix: exclusiveMinimum and exclusiveMaximum are treated as boolean values
    • e8f1856: fix: maintain backwards compatibility on sorting operations by httpVerb
    • cacadd5: fix: consts are rendered as “Schema” in the composition dropdown
    • ad2e3e6: feat: new onBeforeRequest hook to modify the request
    • cacadd5: fix: const value 0, false, null aren’t rendered at all
    • 495588a: refactor: schema type rendering
    • 67d8b9a: fix: updates defined value check in search modal enter action
    • 93b1140: fix: always shows all properties, expand button does nothing
    • 4295067: feat: use xml.name as a fallback for the schema title
    • 8457fde: fix: deprecated operations aren’t striked in the sidebar anymore
    • 2dc9f8d: style: improve search result rendering
    • cacadd5: fix: doesn’t show example if it’s null
    • 0474f02: refactor: create parameters from plain Operation Object
    • 7ea11c1: feat: render x-enum-varnames
    • bd3b6d4: fix: shows composition description three times
    • 3fdc2f2: feat(api-reference): unify inconsistent font styles across scalar client and ref, and improve consistency"
    • Updated dependencies [d56f354]
    • Updated dependencies [b6ac5b9]
    • Updated dependencies [a696604]
    • Updated dependencies [b2862d9]
    • Updated dependencies [dbc09b9]
    • Updated dependencies [ad2e3e6]
    • Updated dependencies [58287f8]
    • Updated dependencies [20939a8]
    • Updated dependencies [909cf33]
    • Updated dependencies [b2862d9]
    • Updated dependencies [74fdc0e]
    • Updated dependencies [ca77d70]
    • Updated dependencies [a696604]
    • Updated dependencies [d93f60c]
    • Updated dependencies [3fdc2f2]
    • Updated dependencies [972602f]
    • Updated dependencies [85a81eb]
    • Updated dependencies [f8ef4ab]
    Open source →
  33. 1.32.125 Jun 2025
    Release notes

    Patch Changes

    • 98ff011: fix(api-references): duplicate section ID for tags on page load
    Open source →
  34. 1.32.025 Jun 2025
    Release notes

    Minor Changes

    • 8d8e427: feat(api-reference): load documents on the new store

    Patch Changes

    Open source →
  35. 1.31.1821 Jun 2025
    Release notes

    Patch Changes

    Open source →
  36. 1.31.1719 Jun 2025
    Release notes

    Patch Changes

    Open source →
  37. 1.31.1519 Jun 2025
    Release notes

    Patch Changes

    • 5f08a45: fix: looks up wrong name for schemas
    • 287eae4: fix: display correct schema type instead of false name
    • 161733e: docs: new README
    • Updated dependencies [979139e]
    • Updated dependencies [aaf90bf]
    Open source →
  38. 1.31.1417 Jun 2025
    Release notes

    Patch Changes

    • 0a94952: fix: remove duplicate operations in x-tag-groups
    • 0e67143: fix: show content encoding description in schema
    • Updated dependencies [1703e42]
    Open source →
  39. 1.31.1216 Jun 2025
    Release notes

    Patch Changes

    • 796f87f: feat(api-reference): export references useSidebar
    • Updated dependencies [b6a1624]
    Open source →
  40. 1.31.1114 Jun 2025
    Release notes

    Patch Changes

    • 1f005c5: fix: updates client libraries footer style
    • c2b00e8: fix: preserves original properties in allof merging
    • 55aadd3: fix: restore breadcrumb in reference slot props
    Open source →
  41. 1.31.1013 Jun 2025
    Release notes

    Patch Changes

    • b12cd8e: fix: updates introduction auth table style
    • 38f0989: fix: only fetch document if we dont have content
    • 85feb90: fix: x-enumDescriptions should be an object
    • Updated dependencies [a5d010c]
    • Updated dependencies [7913193]
    • Updated dependencies [b12cd8e]
    Open source →
  42. 1.31.913 Jun 2025
    Release notes

    Patch Changes

    • 221e35f: feat: added webhooks
    • 8a68bc5: fix: scroll to top to remove hash
    • e611e5f: feat: adds schema name and model get function to schema name helper
    • 4156f1d: Expand workspace store integration
    • 7d97d16: fix: updates api reference workspace dark mode watcher
    • a05d7fe: fix: hides enum ui in discriminator presence
    • b1ea8f0: fix: updates returned merged schema condition for composiion presence
    • e611e5f: fix: updates schema property heading
    • e611e5f: fix: enhances primitives support in schema model name
    • a05d7fe: fix: prevents discrminator recursion in schema property
    • a37df33: fix: enhances introduction optical alignment
    • 711b435: fix: re-create client store on document change
    • c45fdf2: fix: adds better array type object properties rendering
    • Updated dependencies [282129b]
    • Updated dependencies [2974dd6]
    • Updated dependencies [a5b399d]
    • Updated dependencies [221e35f]
    • Updated dependencies [166e298]
    • Updated dependencies [b6ed440]
    • Updated dependencies [4156f1d]
    • Updated dependencies [a37df33]
    • Updated dependencies [711b435]
    • Updated dependencies [7338d56]
    • Updated dependencies [f823d45]
    • Updated dependencies [177438d]
    • Updated dependencies [37c90b8]
    Open source →
  43. 1.31.86 Jun 2025
    Release notes

    Patch Changes

    Open source →
  44. 1.31.76 Jun 2025
    Release notes

    Patch Changes

    • 24cfdfe: feat: adds multiple of in schema property heading
    • Updated dependencies [373214a]
    Open source →
  45. 1.31.65 Jun 2025
    Release notes

    Patch Changes

    • c584dcd: Fix classic layout mobile header
    Open source →
  46. 1.31.45 Jun 2025
    Release notes

    Patch Changes

    Open source →
  47. 1.31.33 Jun 2025
    Release notes

    Patch Changes

    • dc6cd4c: feat: updates download link component
    • 511bbc0: fix: updates header properties style
    • bf2cb82: feat: updates schema composition name handling
    • 7ca47ab: fix: add ssr safe alias for local storage
    • 494f7f0: chore(api-reference): delete rogue Tailwind v3 config
    • Updated dependencies [c06aa6a]
    • Updated dependencies [3ad9393]
    • Updated dependencies [f1c0c01]
    • Updated dependencies [b461b62]
    • Updated dependencies [a47fa60]
    • Updated dependencies [ee3eb77]
    • Updated dependencies [df7efac]
    • Updated dependencies [7ca47ab]
    Open source →
  48. 1.31.230 May 2025
    Release notes

    Patch Changes

    Open source →
  49. 1.31.130 May 2025
    Release notes

    Patch Changes

    • e6c165c: feat: adds schema discriminator and example support
    • aeb94f0: fix(api-reference): size icons for Tailwind v4
    • 237cb44: chore: bump for tailwind fix
    Open source →
  50. 1.31.029 May 2025
    Release notes

    Minor Changes

    • 1e87feb: refactor!: use dereferenced documents as a content source

    Patch Changes

    • a9a4f9f: fix: updates schema property heading logic
    • 8529040: fix: updates search button style
    • f5413ba: fix(api-reference): add tailwind plugin to standalone vite config
    • fea1d52: fix: passes required property to nested schema
    • 785939b: feat: adds id to markdown heading
    • 0113b84: fix(api-reference): add id prefix for useId
    • cad6277: feat(themes)!: migrate to tailwind v4
    • 3a24cf9: feat: save selected client on local storage
    • 0dfb39a: fix: updates schema description handling
    • fea1d52: fix: extracts render schema computed function
    • ffa93fa: feat(themes): use .scalar-app as the base class for all tailwind styles
    • 785939b: feat: updates scroll to hash to handle markdown heading
    • f1f9504: fix: increases z index for references header
    • 42e73ee: fix error when using complex type definitions
    • Updated dependencies [1e87feb]
    • Updated dependencies [785939b]
    • Updated dependencies [1e87feb]
    • Updated dependencies [0113b84]
    • Updated dependencies [cad6277]
    • Updated dependencies [ffa93fa]
    • Updated dependencies [cedca9b]
    Open source →
  51. 1.30.027 May 2025
    Release notes

    Patch Changes

    • 5208e7a: fix: decreases level on single property schema
    • edb5490: feat: adds schema discriminator helper functions
    • 442c0a3: feat: added support for callbacks
    • edb5490: feat: adds schema discriminator support
    • Updated dependencies [151ef09]
    • Updated dependencies [442c0a3]
    • Updated dependencies [edf694b]
    Open source →
  52. 1.29.323 May 2025
    Release notes

    Patch Changes

    • fbcce50: fix: moves download link to section column in introduction component
    • 0afb11d: fix: asses schemas to children object in schema property
    • 9fd408c: fix: updates schema property heading type handling
    • 0afb11d: fix: adds model name function in schema property heading
    • c944864: fix: updates schema composition style and missing value
    • 9ffba73: fix: displays schema references name in property heading
    • Updated dependencies [fbcce50]
    Open source →
  53. 1.29.222 May 2025
    Release notes

    Patch Changes

    Open source →
  54. 1.29.122 May 2025
    Release notes

    Patch Changes

    Open source →
  55. 1.28.3415 May 2025
    Release notes

    Patch Changes

    • 73ecfb0: fix: adds missing schemas to schema property
    • 2056005: fix(api-reference): improve handling of schema discriminators
    • 9946289: feat: show response schema in the response list
    • 40bad87: fix: copy correct path when pathRouting enabled
    • 3a88c94: fix(api-reference): restrict mobile header width
    • 96be9bd: fix(api-reference): handle really long property titles
    • ab0d3a3: fix(api-reference): render required for request body
    • 5129cdc: fix: adds max depth to merge all of schemas
    • be8a6ec: refactor: clean up helpers, remove barrel files
    • Updated dependencies [6b4a3c3]
    • Updated dependencies [be8a6ec]
    • Updated dependencies [1843cfe]
    • Updated dependencies [cd0722d]
    Open source →
  56. 1.28.3312 May 2025
    Release notes

    Patch Changes

    • f711ab5: feat: add auth persistance to references
    • 90b773e: feat: updates heading variables
    • 52dd8a1: fix: displays wrapped auth description on hover
    • 0222ad4: feat: render specification extensions with React
    • ffe6338: fix: displays null and empty default value in property heading
    • 2dadcfb: fix: displays const falsy values
    • Updated dependencies [f711ab5]
    • Updated dependencies [ec30edd]
    • Updated dependencies [90b773e]
    • Updated dependencies [e7f61ce]
    • Updated dependencies [52dd8a1]
    • Updated dependencies [0222ad4]
    • Updated dependencies [cb9428c]
    • Updated dependencies [af38fa6]
    • Updated dependencies [67aa0f4]
    • Updated dependencies [ac16fca]
    • Updated dependencies [1966c5a]
    • Updated dependencies [ac16fca]
    Open source →
  57. 1.28.325 May 2025
    Release notes

    Patch Changes

    • 902f58b: fix: updates prop destructuring defaults in schema property heading
    • cd6cf24: fix: remove old servers then re-add new ones on config.servers change
    • Updated dependencies [e42dfc0]
    • Updated dependencies [4483ac4]
    • Updated dependencies [cd6cf24]
    • Updated dependencies [4483ac4]
    Open source →
  58. 1.28.312 May 2025
    Release notes

    Patch Changes

    Open source →
  59. 1.28.301 May 2025
    Release notes

    Patch Changes

    Open source →
  60. 1.28.291 May 2025
    Release notes

    Patch Changes

    • d2f27f4: fix: updates parameter list item passed value
    • f039486: feat: CSS class for HTTP methods
    • d2f27f4: feat: adds external and object value format example
    • Updated dependencies [a4e5a2e]
    • Updated dependencies [d2f27f4]
    • Updated dependencies [d2f27f4]
    • Updated dependencies [701093e]
    Open source →