Manual API Settings

Provide testing and interactivity to your API endpoint documentation.


You must define your API before you can add API endpoints. In your ReadMe dash, navigate to API Reference > API Definitions > Add your first API

If you have an OAS3 spec file, upload that instead!


Name your API (this will only be visible in the ReadMe dash, customers will not see this name) and set your base URL


You have the usual three authentication methods to choose from. For API Keys you can select whether it is a header or a query param. Typing in authorization will allow you to select the type of authorization as well.

API Explorer

The API explorer is automatically enabled, but you can disable it under additional options. The API proxy is used to prevent and CORS permission errors, so make sure you allow if you turn this off and want the API explorer to work.


You can add additional API Headers and select the Mimetypes of your API requests and responses. We will generate code samples for you automatically, but if you would like to display the one you have in your API setup, simply uncheck this option. If you turn off auto code samples, we will still display any custom examples that you have added to particular endpoints.

When you are done adding your API Settings, head over to the newly created category and start defining your endpoints!

Did this page help you?