Your schema contains $ref. You must provide specification in the third parameter.

[JanEggers]

im trying to update my api with http://editor.asyncapi.org/

I get the errormessage:

Your schema contains $ref. You must provide specification in the third parameter.

Can you please clarify the meaning of that message?

I created the spec back at the 16.03.2018 at that time the document was considered valid.

[fmvilas]

Hey @JanEggers. Could you please provide an example so I can reproduce the bug?

[JanEggers]

https://gist.github.com/JanEggers/ad42fb46c690a55f09ec4b8b6b419ee7

[MikeRalphson]

Sounds suspiciously like a message from https://github.com/APIs-guru/openapi-sampler

[fmvilas]

Mmmm, interesting. Will investigate in the upcoming days. Thanks for reporting @JanEggers and thanks for the clue @MikeRalphson!

[fmvilas]

Hey @JanEggers, I think I found the problem:

"ModeChanged": {
    "properties": {
      "UniqueId": {
         "type": "string"
       },
       "Data": {"$ref": "#/components/schemas/ModeChanged"}
    }
}

The schema ModeChanged is recursive. Its Data property references ModeChanged, which is not supported. However, the editor should not fail this way, so I'll create a fix. Thanks!

[fmvilas]

I updated the editor so it doesn't fail, but documentation will not get rendered correctly anyway.

[JanEggers]

thx