Discussions
Post here or contact Support?
**Wonder what other customers are doing?**
Post here if you're looking for advice or best practices from fellow ReadMe customers!
**Have a problem right now that needs ReadMe attention?**
To report bugs or other issues with your ReadMe project, it's best to reach out to our Support team directly using the Intercom Messenger in the bottom right-hand corner.
**If you need emergency support**
Your project isn't loading, or you're getting 500 errors on mission critical pages? You can open the Intercom widget and type "ReadMe is down" or "getting a 500 error" and we'll be paged. Just include any relevant information about your project (URL, project name) and the error (dev console error, Cloudflare status code) and we'll take it from there!
**File a Feature Request**
Visit [feedback.readme.com](https://feedback.readme.com/tabs/4-candidate/submit-idea) to submit your idea, upvote existing requests, and see our product roadmap!
Posted by Ehsan Mafi over 2 years ago
Enum value used as example appears twice in combo box
Hello,
When declaring in my OpenAPI spec a field such as:
```
"carColor":{"type":"string","example":"WHITE","description":"Color of the car","enum":["WHITE","BLACK","BLUE"]}
```
... then the field appears in Readme with a combo box with the possible values: `WHITE`, `WHITE`, `BLACK`, `BLUE`. If I select the first `WHITE` value, it won't be included in the generated JSON in the right pane (it does work with the other values).
Is there a way to have this value appear only once, be included in the generated JSON and still keep this value as an example?
Thank you,
Eric
Posted by Eric T almost 2 years ago
Import GitHub readme file to Readme
Hi Community,
As the title suggests I am trying to import my github readme file to ReadMe without manually doing the work, also can they be synced? so if I make any changes in Git can they be reflected in ReadMe ?
Posted by IK over 1 year ago
Arbitrary JSON data in API reference
Hi, we have an API endpoint that can take arbitrary JSON in a part of its request body. We tried to express that by using a field with `type: object` and `additionalProperties: true`, and this renders in the API reference as a field where you can add extra fields and give them names and values, but the values are always encoded as strings. So if we type `{ "foo": 2 }` as the value of one of those fields it ends up as `"fieldName": "{ \"foo\": 2}"` in the payload of the request examples.
Is there a way to make the API reference UI not encode those values as strings, but just include them as is in the payload?
Posted by Fabio Mascarenhas about 2 years ago
Quick and easy way to copy paste into a table
Hi! Just wondering if there is an easy way to copy and paste tables from one document (Word, Spreadsheet) into ReadMe?
Posted by MJ almost 2 years ago
Download a csv or zip file
Is there a way to embed a download link in the documentation?
Posted by Dustin Boswell about 1 year ago
OpenAPI download and auto-generated SDKs/code
As we look at and evaluate Readme, one feature that seems common with competitors is the ability for the developer user to download the OpenAPI specification, as well as automatically generated code/SDKs in popular languages from the OpenAPI specification.
These features don't exist in Readme, correct?
Posted by Brendan Keeler about 2 years ago
Filtering "Contacts - Custom Fields Values"
Hi everyone!
I'm trying to use API of Active Campaign to get all the "Contacts - Custom Fields Values" but regarding that, the only way to filter for now is by "fieldedid" or "value" of the custom fields, it's impossible for me to do it.
Do you know whether there is a way like in"Contacts" to filter by creation or update date?
Kind Regards,
Daniel
Posted by Daniel Ruiz over 1 year ago
readOnly properties
Hi,
i see that readOnly properties are part of OpenAPI 3.0.3, that you support, but when I use your site they are not handled correctly.
Intended behaviour of a readOnly property:
1) not being display in body params
2) being displayed in the response body and in the example
same property in editor.swagger.io behaves correctly
is there any plan to fix it ?
thanks in advance
Posted by Mickael Maitre over 1 year ago
Collapsable Sections without HTML
I've been trying to edit our docs so readers can expand and collapse individual section but not having much luck. I know how to do it with HTML but then readme won't render any of the markdown within the section because it looks like HTML. Anyone know how to accomplish this?
HTML Example
''<details>
<summary>TITLE</summary>
but if I add a #header it will display exactly as "#header"
</details>''
Posted by sarah over 1 year ago