Discussions
503/520 errors when attempting to upload openapi schema - "your upload request timed out"
We are attempting to upload schema -- it had worked earlier but is now giving errors. Cannot tell if this is user error, or server errors
Search results appearing for content no longer in a project
Hello! We recently migrated a project into 2 projects.
Show Image preview in Try It! response
We have an API endpoint that is documented in OpenAPI as returning an image:
Updating API specification doesn't work
I am doing a PUT request, tried both with a JSON and YAML, I'm getting a 503 error.
The tried specifications are valid.
Support pages directly from OpenAPI spec
Many APIs use info.description field to describe the API context (such as introduction and getting started), but currently according to the OpenAPI Compatibility Chart it currently does nothing. It will be very nice if pages could be created automatically using this field.
Is there a way to define custom headers/parameters to be shared across all endpoints/paths in a given JSON?
I have a use case in hand where I have some custom headers that should be shared across all the described endpoint paths in a given JSON.
What is the best way to import a subdirectory of images and other
In the rdme CLI, I'm trying to import the MD folder that has an /images subdirectory. Is there another tool that can import bulk image and downloadable code samples?
Is it possible to upload a text file (code snippet) for users to download?
To get my users going on Postman they need a code snippet that they then export to their Postman collection, which is best done as a JSON file. It is not, however, in OAS. Is there a way to upload this file for them to download rather than asking them to copy and paste the snippet from a page etc.?
200 sample response not showing in endpoint
I have a swagger 2.0 definition, which seems to get transformed to openapi 3 in readme. Within this definition, some endpoints show the 200 sample response at the right hand side of the page (below the call console), and some others don't show any sample response. I compared the paths between endpoints and they seem to be equal. The only difference between these endpoints is that one path/response points to a schema with required params, while the other pointed schema doesn't have required params (although, if I change that it doesn't seem to have an effect).
Add Reference API in my application
Good morning dear,
a query you might be able to embed an api reference in my app outside of Readme.