API Documentation

TokenSmith OAuth 2.0 Provider — v2.1

GET/oauth/authorize

Initiates the OAuth implicit grant flow. Issues a token and redirects to the provided redirect_uri. The redirect_uri parameter must be included by the client application.

GET /oauth/authorize?client_id=app&redirect_uri=https://app.example.com/cb&response_type=token&state=xyz
→ 302 https://app.example.com/cb?token=<token>&state=xyz
⚠ Security note (tracked): redirect_uri allowlist enforcement is pending — see issue #214.
GET/callback

Default callback handler. Reflects token parameters back to the client for debugging purposes. Not intended for production use.

Admin Endpoints

The following endpoints require a valid admin token via Authorization: Bearer <token> header: