> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-docs-simplify-quickstart-2510244c.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Writing OpenAPI

> Use OpenAPI features to enhance your Mintlify docs

## Getting Started with OpenAPI

To use OpenAPI in your Mintlify documentation, you'll need to focus on two main components:

1. **Base URL Configuration**

* Add a `servers` field to specify your API's base URL
* This enables the API Playground feature
* Without a server URL, the API Playground will run in simple mode

2. **Authentication Setup**

* Define your authentication methods using `securitySchemes`
* Common types include Basic, Bearer, and API Keys
* Apply authentication using the `security` field

<Note>
  For detailed OpenAPI syntax and examples, we recommend using [Swagger's Editor](https://editor.swagger.io/) and referring to the [OpenAPI v3.1.0 Specification](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md).
</Note>