Discussions
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?
Posted by laurent malka 24 days ago
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>
Posted by Gaurav Ajmera 29 days ago
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?
Posted by null about 1 month ago
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.
Posted by null 3 months ago
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?
Posted by Josue Negron 5 months ago
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?
Posted by Samantha Voigt 5 months ago
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.
Posted by Thimo Bosma 5 months ago
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?
Posted by Mariusz Balawajder 5 months ago
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
Posted by Diego A. Leon 6 months ago
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"
}
}
}
```
Posted by Eduard Isakhanyan 6 months ago