Discussions
Let your customers register on readme
Hi fellow API developers
We just recently started to document all our API stuff on readme, and I wonder if there is a way for my clients to register as a developer on my readme portal? As I would like to have a way of reaching out to them with news, updates etc. Is this possible in readme?
Posted by Stefan Eklund 6 months ago
Multipart/form-data properties are not generated correctly
I have an endpoint that consumes a `multipart/form-data` It takes a file and other properties. some of the properties are objects.
Below is how Readme renders the properties
```
const sdk = require('api')('@fr0sty/v1.0#3y00k1blog8la60');
sdk.uploadKnowledgeDocument({
newKey: 'New Value',
appVisibility: 'visible',
name: 'Product Release Monthly Webinar - May 2023',
file: 'starbucks%20brand%20voice.pdf'
})
.then(({ data }) => console.log(data))
.catch(err => console.error(err));
```
`newKey` should be inside an object with a key of `metadata` and `appVisibility` should inside an object with key `settings`
Below is how it should look.
```
const sdk = require('api')('@fr0sty/v1.0#3y00k1blog8la60');
sdk.uploadKnowledgeDocument({
metadata: { newKey: 'New Value'},
settings: {appVisibility: 'visible'},
name: 'Product Release Monthly Webinar - May 2023',
file: 'starbucks%20brand%20voice.pdf'
})
.then(({ data }) => console.log(data))
.catch(err => console.error(err));
```
Stoplight & Swagger-UI produce the above result. Why does `Readme` not include the `metadata` & `settings` key in the object?
Posted by Richard David 6 months ago
Synchronization with Symfony
I assume that it's not currently possible to sync a Readme with a Symfony app except with GitHub Actions. It would be great to use API plateform features to automatically sync data and generate Readme content. I haven't found anything in discussions about this, is something like this possible and planned in the future?
Posted by Gwendal 6 months ago
Can you use a custom domain for API docs with free or startup plans?
Like the title says! I'm curious if you can use a custom domain when you aren't on the enterprise plan. Thanks!
Posted by Andrea A 6 months ago
Remove a discussion thread
Is it possible to remove a discussion thread from the Discussions page?
Thank you :)
Posted by Alex 6 months ago
How to add "description" to response body parameters in the example code.
While adding the API endpoint in the API reference I am not able to find the option to add the API response body parameter description.
Posted by Shreyas Sridhar 6 months ago
Password protect just one page
Hello! Is it possible to password protect just one page of our documentation?
Posted by Emily Zhao 6 months ago
Discriminator doesn't seem to be recognized
Hello, we have the following section in our openapi definition file:
```
...
requestBody:
required: true
content:
application/json:
schema:
oneOf:
- $ref: "./components/auth.yml#/schemas/UserCredentialRequest"
- $ref: "./components/auth.yml#/schemas/RefreshTokenRequest"
- $ref: "./components/auth.yml#/schemas/AuthorizationCodeRequest"
discriminator:
propertyName: grant_type
mapping:
password: "./components/auth.yml#/schemas/UserCredentialRequest"
refresh_token: "./components/auth.yml#/schemas/RefreshTokenRequest"
authorization_code: "./components/auth.yml#/schemas/AuthorizationCodeRequest"
...
```
Somehow, the request body is not rendered in the UI, this is what we see:
<https://pasteboard.co/toDL5B2pvcA0.png>
Is it a bug or are we doing something wrong? The same exact openapi definition works with \[redocly](<https://redocly.com/>) without any changes.
Posted by null 6 months ago
How to remove auto generated examples
Hi, we are using an OpenAPI schema to create our API reference on Readme. We find that the auto generated language examples often confuse our users or put them on the wrong track (we'd prefer developers use our own SDK).
Is there a way to completely disable the auto generated examples when using an imported OAS, or at least limit the languages that are displayed? Alternately, is it possible to provide our own examples instead?
Posted by David Browne 6 months ago
Left menu items - ordering
What is the logic used to order the openapi tags in the rendered page? Is there a way to influence the order of the pages in the left menu? I read this: <https://docs.readme.com/main/docs/openapi-categories-pages-subpages#tags> - but I still don't understand how is the order of the menu in the left defined.
Let's say I have the following tags in my `openapi.yaml`:
```
tags:
- name: Page1
- name: Page2
- name: Page3
```
What I want is, to have menu items in the left pane of the docs page ordered in the same order as I specified in my `openapi.yaml` file. Currently the order is not preserved and I can't understand what algorithm is used to detect the order.
Posted by null 7 months ago