Property $ref is not allowed.yaml-schema: openapi:v3_1_2020(513)

[lynn-beckman]

A formatting warning is shown when referencing a file in multi-file OpenAPI spec mode:

openapi: 3.1.0
info:
  title: Example API
  version: 1.0.0  
components:
  schemas:
    Carrier:
      $ref: './components/schemas/carriers/Carrier.yaml'

[Druid33]

Hi,
same issue with "openapi": "3.1.1"

OpenAPI (Swagger) Editor: Version 4.38.0

VSCode:
Version: 1.103.2
Commit: 6f17636121051a53c88d3e605c491d22af2ba755
Date: 2025-08-20T16:45:34.255Z
Electron: 37.2.3
ElectronBuildId: 12035395
Chromium: 138.0.7204.100
Node.js: 22.17.0
V8: 13.8.500258-electron.0
OS: Linux x64 6.14.0-29-generic

[anthony-42crunch]

Thanks for reporting, or developers will look into it.
A quick workaround that appears to work is wrapping $ref in 'allOf'

[designvoid]

Any update on this? Still happening.... :(

[ak1394]

Apologies... will see if we can fix it in the next release

[designvoid]

No worries - happy to help with testing if it helps!

[ak1394]

I've fixed the issue, but it'll be few weeks till it's out. If you like, I can give you a .vsix build from the dev branch, so you don't have to wait.