> ## 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.

# MDX Setup

> Generate API documentation with MDX

Mintlify helps you create interactive API documentation using MDX files and the `mint.json` configuration. This setup enables API playground functionality, request examples, and response examples.

<Steps>
  <Step title="Configure API settings">
    Add your API configuration to `mint.json`:

    ```json
    {
      "api": {
        "baseUrl": "https://mintlify.com/api",
        "auth": {
          "method": "bearer"
        }
      }
    }
    ```

    To hide the API playground, use:

    ```json
    {
      "api": {
        "playground": {
          "mode": "hide"
        }
      }
    }
    ```

    See all API configuration options in our [reference guide](/settings/global#api-configurations).
  </Step>

  <Step title="Create endpoint pages">
    For each endpoint, create an MDX file with the following frontmatter:

    ```md
    ---
    title: 'Create new user'
    api: 'POST https://api.mintlify.com/user'
    ---
    ```

    Use `{parameterName}` for path parameters:

    ```
    https://api.example.com/v1/users/{userId}
    ```

    <Note>
      With `baseUrl` configured, you can use relative paths like `/v1/users`
    </Note>
  </Step>

  <Step title="Add to navigation">
    Add your endpoint pages to the `navigation` field in `mint.json`. Learn more about navigation [here](/settings/navigation).
  </Step>
</Steps>