OpenAPI widget does not support nested objects

[kfc2023]

What's your feature/idea?

When I use the OpenAPI widget to embed a method, the nested articles don't link to the associated models. This leaves out a huge component of my spec. Linking nested objects would be awesome.

What's your desired outcome?

Use gitbook as the sole source of documentation for my external api. right now, the details of the nested objects aren't accessible.

What's the impact of this for you?

• Critical
• High
• Medium
• Low

Anything else?

No response

[rachellawson]

This looks like something we are also needing.

[FiveOFive]

Sounds like what we need as well. Specifically the issue we're running into is that references and inheritance aren't included in the schema section of the OpenAPI widget. They do get included in the Example section.

[aikoii]

Hey @FiveOFive, AFAIK, the schema should be working with nested references and objects. If you could share (support@gitbook.com) the spec you are using, we can test it out 🙏 and see if there is a bug.

[kfc2023]

the value of the openapi widget is limited if you still have to provide a link to the swagger output to provide all the info necessary to use the method.

…

On Wed, Aug 9, 2023 at 8:24 AM Kyle ***@***.***> wrote: Sounds like what we need as well. Specifically the issue we're running into is that references <https://swagger.io/docs/specification/using-ref/> and inheritance <https://swagger.io/docs/specification/data-models/inheritance-and-polymorphism/> don't show to be included in the schema section of the OpenAPI widget. They do get included in the Example section. — Reply to this email directly, view it on GitHub <#132 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/A6F7GSM22JUZQ7Q2FFKPA3TXUOTSXANCNFSM6AAAAAAVN6QMNY> . You are receiving this because you authored the thread.Message ID: ***@***.***>

[aikoii]

Thanks for your input! We totally understand our OpenAPI block is not complete yet, and it's on our radar in the coming time🤞.