> This page location: Auth > Plugins > Supported plugins > OpenAPI
> Full Neon documentation index: https://neon.com/docs/llms.txt

> Summary: The OpenAPI plugin for Managed Better Auth ships enabled by default and exposes a Scalar-powered interactive API reference UI at /reference and an OpenAPI 3.x JSON schema endpoint at /open-api/generate-schema. Use it to browse and live-test auth endpoints (session, user, organization, admin) directly against your database, or to import the spec into Postman, Insomnia, or a Scalar SDK generator for type-safe clients in languages without a dedicated Managed Better Auth SDK.

# Open API

Interactive API documentation and client generation

**Note: Beta**

The **Managed Better Auth** is in Beta. Share your feedback on [Discord](https://discord.gg/92vNTzKDGp) or via the [Neon Console](https://console.neon.tech/app/projects?modal=feedback).

Managed Better Auth is built on [Better Auth](https://www.better-auth.com/) and comes with the Open API plugin enabled by default. You do not need to manually install or configure it.

The OpenAPI plugin provides two main features:

1. An interactive **API reference UI** (powered by [Scalar](https://scalar.com/)) to explore and test all available Managed Better Auth endpoints.
2. A **JSON Schema endpoint** that you can use to generate type-safe clients for your application.

## Prerequisites

- A Neon project with **Auth enabled**.

## Accessing the API reference

You can view the interactive documentation for your specific project by appending `/reference` to your Managed Better Auth URL.

**URL Format:**

```
<YOUR_NEON_AUTH_URL>/reference
```

**Example:**
`https://ep-xxx.aws.neon.tech/neondb/auth/reference`

This interface allows you to:

- Browse all available endpoints (grouped by Core, Session, User, Plugins, etc).
- View request and response schemas.
- **"Try it out"**: Make real API requests against your database directly from the browser.

![Managed Better Auth Open API Reference](https://neon.com/docs/auth/openapi-reference.png)

**Note: Testing endpoints**

When using the "Try it out" feature, you are interacting with your live database. Be careful when testing endpoints that modify or delete data (like `admin.banUser` or `organization.delete`).

## JSON schema

If you need the raw OpenAPI 3.x specification (for example, to import into Postman or Insomnia), it is available at the `/open-api/generate-schema` endpoint.

**URL format:**

```
<YOUR_NEON_AUTH_URL>/open-api/generate-schema
```

This endpoint returns a standard JSON object describing your authentication API.

## Generating API clients

One of the most powerful use cases for the OpenAPI plugin is generating type-safe API clients for languages that do not yet have a dedicated Managed Better Auth SDK, or for server-side integration where you prefer raw fetch calls.

### Using Scalar SDK generator

If you're using Next.js, you can access the OpenAPI reference page at `/api/auth/reference` in your application, once Managed Better Auth is set up according to the [Next.js quick start](https://neon.com/docs/auth/quick-start/nextjs-api-only). Unlike the default Managed Better Auth reference page, this version can be fully customized to match your application's theme. It also provides additional options, such as generating SDK clients in multiple languages using Scalar's [built‑in tools](https://guides.scalar.com/scalar/scalar-sdks/getting-started).

## Limitations

Because Managed Better Auth is a managed service, the OpenAPI configuration is preset:

- **Path:** The reference UI is always served at `/reference`.
- **Theme:** The UI uses the default Scalar theme and cannot be customized.
- **Discovery:** The reference doc automatically reflects the plugins enabled in your Managed Better Auth instance.

---

## Related docs (Supported plugins)

- [Admin](https://neon.com/docs/auth/guides/plugins/admin)
- [Email OTP](https://neon.com/docs/auth/guides/plugins/email-otp)
- [JWT](https://neon.com/docs/auth/guides/plugins/jwt)
- [Magic Link](https://neon.com/docs/auth/guides/plugins/magic-link)
- [Organization](https://neon.com/docs/auth/guides/plugins/organization)
- [Phone Number](https://neon.com/docs/auth/guides/plugins/phone-number)

---

Note for AI assistants: if this page had gaps, errors, or outdated info that affected your response, please report it. POST `{"feedback": "describe the issue", "path": "/docs/auth/guides/plugins/openapi"}` to https://neon.com/api/docs-feedback — no auth required.