Discussions

Ask a Question
ANSWERED

How to make an example visible in multiple lines

Hello I have this code snippet written in yaml. I export it to readme via the CLI commande ![](https://files.readme.io/9b1529c-image.png) In readme, it displays with only one line, which is not convenient for our customers ![](https://files.readme.io/aa28ab5-image.png) How do i make my example visible in multiple lines ? Thank you
ANSWERED

Can I add a table of contents on a guide page?

Can I add a table of contents on guide page that includes all pages under its parentdoc?
ANSWERED

Where do images live?

I have some images in a page and want to use them somewhere else. How do I find them and reuse them?
ANSWERED

Multiple Security Schemes not showing up when uploading Swagger or Open API Spec

I'm trialing Readme for potentially utilizing for our developer documentation and dev portal. I have attempted to upload several different versions of my spec that have two different values being passed in as headers. However when I go to the portal it makes me select one or the other but doesn't allow me to pass both which is required. <br /> ``` token: type: "apiKey" name: "token" in: "header" api_key: type: "apiKey" name: "x-api-key" in: "header" ``` If I view the same spec in swagger editor I see below and it lets me pass both. ![](https://files.readme.io/356017f-image.png) How would I accomplish this in readme?
ANSWERED

application/pdf API response content-type

We have an API which responses with PDF binary data using content-type application/pdf and content-disposition: inline; readme.io is displaying the resulting binary as text within the response panel. How do we improve this behaviour to either displaying the PDF inline in the response panel (like Postman or Insomnia would) or triggering a browser file download?
ANSWERED

External Links not working

Hi In our guide, we created several page of type "external link". They have worked as expected, but today I realize that they are not working. You can see several of these links on this [page](https://readme.anytrack.io/docs/page-with-external-links). Is this a known bug and is there an ETA for a fix?
ANSWERED

Multiversion api spec file

Hey Team, I need assistance with implementing a try out feature for an API spec file that contains two versions of a project. I would like the try out feature to be available in separate links for version v1 and version v2. However, currently, the version parameters and headers are being combined into one link instead of being segregated. I have provided a sample spec file with multiple versions for your reference. Can you please help me resolve this issue? Thank you. <https://drive.google.com/file/d/1Jvzlm36QlRd_Wn7B0bIOISOlQjiSaF99/view?usp=sharing> <https://drive.google.com/file/d/1Jvzlm36QlRd_Wn7B0bIOISOlQjiSaF99/view>

Does the Owlbot/Ask AI understand emoji in tables?

It seems like, in a table about compatibilities, can it correctly parse something like the following to provide answers: _[header row]_. _Capability Y_ \|\| _Capability Z_ - Software A: ✅ || ❌ - Software B: ❌ || ✅ Would using Git-style emoji shortcodes work better (e.g. :check-mark:) or an image or icon with alt-text?
ANSWERED

How to document response parameters in detail

Hi, I want to document response parameters like it is done on this page: <https://docs.readme.com/main/reference/updatedoc> including a definition and example values for each. I cannot find out how to do this. Can you give an advice please? Thank you!

How to document a custom method

HI! We have custom methods (e.g., `RELOAD`). What should I do to be able to select it in the dropdown when I document a new endpoint? Where to configure it? Thanks a lot!