Can only describe subkeys of "paths:"

[wnoise]

It would be useful to be able to describe schemas in the "Components" subsection of the root.

[jonschumacher]

Probably not relevant anymore, but for future reference there is the option to add optional_fields as a dict:

optional_fields["components"]["schemas"]["Order"] = Dict{String, Any}(
  "title" => "Pet Order",
  "description" => "An order for a pets from the pet store",
  "type" => "object",
  "properties" => Dict{String, Any}(
    "id" => Dict{String, Any}(
      "type" => "integer",
      "format" => "int64"
    ),
    "petId" => Dict{String, Any}(
      "type" => "integer",
      "format" => "int64"
    )
  )
)


info = Dict("title" => "TestAPI", "version" => string(pkgversion(@__MODULE__)))
openApi = OpenAPI("3.0", info; optional_fields)
swagger_document = build(openApi)