Discussions

Ask a Question

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?

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?

Ability to ban or delete users

Currently, anyone at anytime can make an account in the Discussions section, and spam the hell out of it. There is no way to prevent this, or stop the spammer from continuing. CAPTCHAs are not a solution, as that does not prevent human driven spam, and the bad actor can do this every day, forever. I'm puzzled how this is not a feature of a public discussion forum. Please make this a thing.

Can you add the ability to export APIs into PDF?

I noticed you can only export Guides, we have lots of internal users asking for PDF exports of the APIs and I have been using <https://www.npmjs.com/package/apibake>, can we get this into the product?

URL encode query parameters in API Reference

My API allows query parameters that can contain special characters (for example, phone numbers with a `+` prefix). When users plug in the string with the special characters into the relevant query param in the API Reference and click "try it!" they expect for the special characters to be encoded correctly into the URL within the generated CURL. Is this a feature we can enable?

Adding a version prompts error: Error submitting form

Hi, When I try to add a new version I'm getting an error 'Error submitting form' without more details for troubleshooting. I'm trying to fork my only other version. Any pointers would be great.

Missing body parameters

![](https://files.readme.io/d20059e-image.png) Hey, I'm trying to configure Readme.com to show OpenApi specs but it does not always work. Some endpoints are ok but most of them have no body params at all (the same works in swagger/other open api hosting tool we currently use). Also, OpenApi file is valid according to rdme: "... is a valid OpenAPI API definition!" Is there any debug mode or logs I could check to analyse this issue?

404 on api reference section

Im having trouble making a readme file in readme.com where if click api-reference button no navbar takes me to a 404 not foud page, even if i have docs and pages created

Nested Discriminator support

Hey Readme.io community I would like to know how I can achieve nested discriminator oneOf -> oneOf nested. When I have a nested oneOf property it does not take first discriminator for "channel" ![](https://files.readme.io/8cea777-Screenshot_2024-02-09_at_13.06.08.png) ![](https://files.readme.io/260ebad-Screenshot_2024-02-09_at_13.06.21.png) Example Code ```json "oneOf": [ { "$ref": "#/components/schemas/TemplateSMSPostRequestDto" }, { "$ref": "#/components/schemas/TemplateViberPostRequestDto" } ], "discriminator": { "propertyName": "channel", "mapping": { "SMS": "#/components/schemas/TemplateSMSPostRequestDto", "VIBER": "#/components/schemas/TemplateViberPostRequestDto" } } ``` TemplateSMSPostRequestDto ```json { "title": "SMS Template", "type": "object", "required": [ "text", "channel" ], "properties": { "channel": { "type": "string" }, "text": { "type": "string", "maxLength": 1000 } } } ``` TemplateViberPostRequestDto ```json { "title": "Viber Template", "type": "object", "allOf": [ { "required": [ "channel" ], "properties": { "channel": { "type": "string" } } }, { "oneOf": [ { "$ref": "#/components/schemas/TemplateViberImagePostRequestDto" }, { "$ref": "#/components/schemas/TemplateViberDocumentPostRequestDto" } ], "discriminator": { "propertyName": "type", "mapping": { "image": "#/components/schemas/TemplateViberImagePostRequestDto", "document": "#/components/schemas/TemplateViberDocumentPostRequestDto" } } } ] } ``` TemplateViberImagePostRequestDto ```json { "title": "Image Template", "type": "object", "required": [ "type", "channel" ], "properties": { "type": { "type": "string" }, "text": { "type": "string" }, "url": { "type": "string", "description": "One of 'url' or 'media_id' is required" }, "media_id": { "type": "string", "format": "uuid", "description": "One of 'url' or 'media_id' is required" } } } ``` TemplateViberDocumentPostRequestDto ```json { "title": "Document Template", "type": "object", "required": [ "type", "filename", "channel" ], "properties": { "type": { "type": "string" }, "filename": { "type": "string" }, "url": { "type": "string" }, "media_id": { "type": "string", "format": "uuid" } } } ```