> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meridian.surf/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAPI

> Machine-readable OpenAPI spec for the Meridian OAuth API.

OAuth endpoints are documented in prose under [Endpoints](/api/endpoints) and [Authentication](/api/authentication). For machine-readable schemas, request bodies, and response shapes, use the OpenAPI 3.1 spec:

```text theme={null}
https://api.meridian.surf/openapi.json
```

Import it into Postman, Insomnia, or your codegen tool of choice. The spec covers:

* Authorization (`GET /auth/consent`)
* Token exchange and refresh (`POST /api/oauth/token`)
* Userinfo (`GET /api/oauth/userinfo`)
* Revoke (`POST /api/oauth/revoke`)
* Scope definitions and response schemas

<Tip>
  Prefer `https://api.meridian.surf/openapi.json` as the canonical URL. Older docs may still mention `docs-backend.meridian.surf`; that host is retired.
</Tip>