Skip to content

API Reference

Tinyauth provides a full REST API for OAuth2 and OpenID Connect operations.

For a complete, interactive API reference with request/response examples and a built-in API client, visit the Interactive API Docs.

The interactive documentation is powered by Scalar and includes:

  • All available API endpoints grouped by tags
  • Request/response schemas with examples
  • Built-in API client for testing endpoints
  • Authentication support (Bearer JWT)
TagDescription
AuthUser authentication (login, register, password management)
UserUser profile and account management
ConsentOAuth consent management
TermsTerms of service management
OAuth ConnectThird-party OAuth provider connections
OpenIDOpenID Connect protocol endpoints (authorize, token, userinfo, JWKS)
HealthServer health check

The raw OpenAPI 3.1 specification is available as a JSON file:

  • Static spec: /openapi.json (bundled at build time)
  • Live UI (when running the server with openapi.enabled: true): GET /api/docs
  • Live spec (when running the server with openapi.enabled: true): GET /api/docs/json