Made in DeveloperHub
FAQ
Why is request/response body empty even though there is a schema object?
Check that your schema object defines a type. If it doesn't, then we'll show the text <type> in the table. properties by itself is not enough to denote that the schema is an object.
For example:
content application/json schema properties id typenumber name typestringHow do I reorder Operations?
Operations (for example GET /version , POST /reference) are ordered according to how they are ordered in the OpenAPI definition itself. We use tags to group the operations, but we do not modify the order. For example:
# If the operations and tags are specified as such in the API definition:paths '/cat' post tagsCats ... get tagsCats ... '/dog' get tagsDogs ... post tagsDogs ...tagsname'Dogs'name'Cats' # The operations and tags would be ordered as such in the API reference:# Dogs# GET /dog# POST /dog# Cats# POST /cat# GET /catFeel free to reorder the operations in your OpenAPI definition as needed to create the right journey for your readers.
Unfortunately, due to limitations in the API editor, reordering operations from the source view in the API editor has no effect. The operations must be reordered locally on a file, and uploaded as an API reference import to take effect.