Discussions

Ask a Question
ANSWERED

Lack of Int64 support in Try Me feature

It seems the frontend (try me) section of Readme does not properly support Int64 data type and is overflowing. An entity with this id 628581038777243835 is returned as 628581038777243800. I assume you need to update your frontend to make proper use of BigInt (<https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt>) here Best, Christian
ANSWERED

Why is my OpenApi file being marked as invalid?

Currently working on a test project with Readme for the first time and wanted to try and bring over my Postman collection. I went through the process of creating an OpenApi file with my Postman collection but when I upload it to Readme I get an error stating: ![](https://files.readme.io/fc270840596658faeb7fb442803beccf76816cbb92151cef2978b095efcbbc8c-image.png) I'm not sure what the issue is here as this doesn't seem to match the actual file? Line 1 in the input file doesn't have a fourth position from what I can tell but maybe I'm missing something as this is my first time trying to utilize this. ![](https://files.readme.io/b95a93528439a86891ef3c24f194831c017f30a721b03986cf866b6768f3506a-image.png)
ANSWERED

Why in some APIs default schema is shown under the curl request?

In the API reference, under the curl request section, for some of the APIs default API schema is shown which also overrides the examples. This changes the actual API example schema. Suggest how this can be fixed.

Can we have Oauth and Sso together

Let say our company have independent sso provider for authentication and oauth2 for authorization (with application code flow).. how can we integrate both? Expectation is users will redirect to my company SSO for login and readme will call oauth2 for authentication...
ANSWERED

Displaying H4s in TOC

I know that the TOC is rendered server-side, but is it possible to tweak the CSS/JS in such a way to get it to include H4s? For SEO reasons all of my guides have to start with H2s, so the H4s really act as H3s, and not having them in the TOC makes page navigation harder than I'd like.

intercom search box

Hi When searching docs via intercom messenger we're getting an error. ``` { "support_url": null, "error_code": "third_party_request_error", "message": "Something went wrong with the third party server during the request" } ```
ANSWERED

Howdo I publish a notebook?

My dev team has shared an IPYNB format notebook that contains a code example for using our API. This is hosted in GitHub. Is it possible to publish this as a recipe directly using the GitHub link? Thanks.
ANSWERED

My Discussion board is getting spammed with erroneous posts

This evening my discussion board went wild with dozens of posts in rapid succession. None of the post are relevant to my docs nor my business (they all appear to be customer service pages from fortune 500 companies...weird). I disabled the discussion board to stop the spamming but this is not a desired outcome. Is there anyway to block select users from posting on my discussion board? I can see who the spmmers are in read.me and could block them if there was a way.
ANSWERED

Alternate for API Explorer

Is there any alternate for `https://www.npmjs.com/package/@readme/api-explorer`?
ANSWERED

Is it possible to nest categories within categories in Guides?

Hello, First post. Just getting started learning ReadMe. I have at least 4 APIs to get into a new project and I'm not sure how best to group each API's content in Guides. I was thinking that each category would be an API name with sub-categories for features of that API. I know you can nest pages in a category. E.g. ``` C1 P1 P2 P3 C2 ``` Can I nest categories within categories? E.g. ``` C1 C2 P1 P2 P3 C3 P4 P5 P6 C4 ``` I don't see a way to do this. What's the best practice? Maybe use Versioning to make each API it's own entry from a drop-down? Maybe create a version for Search API v9, Location API v1, etc.? Thanks!