Development › API Docs (Swagger)

Swagger / OpenAPI (API Gateway)

Interactive API docs are powered by Scramble (OpenAPI 3 + Stoplight Elements UI).

#URLs

URLWhat
http://localhost:8000/docs/apiSwagger-style UI
http://localhost:8000/docs/api.jsonOpenAPI JSON

#Auth in the UI

  1. POST /api/auth/login (Try it) → copy data.token
  2. Click Authorize → paste token as Bearer
  3. Call protected endpoints (/api/auth/me, /api/v1/...)

#What is documented

Routes under the api path prefix, including:

#Docker

Rebuild the API image after installing Scramble so the container has the package:

docker compose up -d --build app

Then open http://localhost:8000/docs/api

Edit this page on GitHub